Disk Operating System Monitor 
Programmer’s Handbook 


DEC-11- OMONA-A-D 


PDP-11 

DISK OPERATING SYSTEM MONITOR 
PROGRAMMER'S HANDBOOK 


Monitor Version V08-J02 


October 1972 


SOFTWARE SUPPORT CATEGORY 


The software described in this document 
is supported by DEC under Category I , 
as defined on page iv of this document. 


For additional copies, order No. DEC-ll-OMONA-A-D from DEC, 
Software Distribution Services, Maynard, Mass. 01754 


DIGITAL EQUIPMENT CORPORATION • MAYNARD, MASSACHUSETTS 




First Printing, May 1971 
Revised, August 1971 
Revised, February 1972 
Revised, October 1972 


Your attention is invited to the last two 
pages of this document. The "How to Obtain 
Software Information" page tells -you how to 
keep up-to-date with DEC'S software. The 
"Reader's Comments" page, when filled in 
and mailed, is beneficial to both you and 
DEC; all comments received are acknowledged 
and are considered when documenting subsequent 
documents . 


Copyright (cj 1971, 1972 by Digital Equipment Corporation 


NOTE 

The material in this manual is for information 
purposes and is subject to change without notice. 
DEC assumes no responsibility for the use or 
reliability of its software on equipment which 
is not supplied by DEC. 


Associated Documents: 


PDP-11 FORTRAN IV 

Programmer's Manual, DEC-ll-LFIVA-A-D 

PDP-11 MACRO-11 Assembler, 

Programmer's Manual, DEC-11-0MACA-A-D 

PDP-11 Edit-11 Text Editor, 

Programmer's Manual, DEC-ll-EEDA-A 

PDP-11 0DT-11R Debugging Program, 

Programmer's Manual, DEC-11-00DA-D 

PDP-11 Link-11 Linker and Libr-11 Librarian 
Programmer's Manual, DEC-ll-ULLMA-A-D 

PDP-11 PIP, File Utility Package, 

Programmer's Manual, DEC-ll-UPUPA-A-D 


The following are trademarks of 
Digital Equipment Corporation. 

PDP 
FOCAL 

COMPUTER LAB 
OMNIBUS 


DEC 

FLIP CHIP 
DIGITAL (logo) 
UNIBUS 


n 



PREFACE 


This document contains a comprehensive description of the PDP-11 Disk Operating System 
Monitor. The document is written for the PDP-11 programmer — it assumes familiarity with 
the contents of the PDP-11 Handbook 1971 and the MACRO-11 Assembler (see document 
number DEC-1 1 -OMACA-A-D), Previous experience with monitor or executive systems 
would be helpful . 

The document is separated into three chapters: Chapter 1 is an introduction to the DOS 
Monitor, and provides general information about the disk operating system. Chapter 2 
describes the keyboard commands available to the system operator through the Monitor; 
concepts and operation of each command are also explained. Chapter 3 describes the pro- 
grammed requests that are available to the programmer through the Monitor. This chapter 
also explains the concepts and operation of each programmed request. The entire document 
is summarized in the appendices. Appendices D (Monitor Commands) and E (Monitor 
Programmed Requests) should prove to be invaluable to the DOS user. 

In addition to the DOS Monitor, the PDP-11 Disk Operating System Software includes: 

FORTRAN IV 
MACRO-1 1 Assembler 
i t py * 

L.VU II 1 1 ICAI UUIHJI 

ODT-11R Debugging Program 
PIP, File Utility Package 
Link-11 Linker 
Libr-1 1 Librarian 
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SOFTWARE SUPPORT CATEGORIES 


Digital Equipment Corporation (DEC) makes available four categories of software. These 
categories reflect the types of support a customer may expect from DEC for a specified software 
product. DEC reserves the right to change the category of a software product at any time. 

The four categories are as follows: 


CATEGORY I 

Software Products Supported at no Charge 

This classification includes current versions of monitors, programming languages, and 
support programs provided by DEC. DEC will provide installation (when applicable), advisory, 
and remedial support at no charge. These services are limited to original purchasers of DEC 
computer systems who have the requisite DEC equipment and software products. 

At the option of DEC, a software product may be recategorized from Category I to 
Category II for a particular customer if the software product has been modified by the customer 
or a third party . 


CATEGORY II 

Software Products that Receive Support for a Fee 

This category includes prior versions of Category I programs and all other programs avail- 
able from DEC for which support is given. Programming assistance (additional support), as 
available, will be provided on these DEC programs and non-DEC programs when used in con- 
junction with these DEC programs and equipment supplied by DEC . 


CATEGORY III 
Pre-Release Software 

DEC may elect to release certain software products to customers in order to facilitate 
final testing and/or customer familiarization. In this event, DEC will limit the use of such 
p re _ re | ease software to internal, non-competitive applications. Category III software is only 
supported by DEC where this support is consistent with evaluation of the software product. 
While DEC will be grateful for the reporting of any criticism and suggestions pertaining to a 
pre-release, there exists no commitment to respond to these reports. 


CATEGORY IV 
N o n - S u p po r t e d Software 

This category includes all programs for which no support is given 
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CHAPTER 1 
INTRODUCTION 


1.1 THE DOS MONITOR 


The PDP-11 Disk Operating System (DOS) Monitor is a powerful, 
keyboard-oriented, program development system designed for use on 
PDP-11 computers. The DOS Monitor facilitates use of a wide range 
of peripherals available for use with the PDP-11. 


The DOS Monitor supports the PDP-11 user throughout the de- 
velopment and execution of his program by: 


• providing convenient access to system programs 
and utilities such as the FORTRAN Compiler 1 , 
the MACRO-11 Assembler 1 , a Linker, a debugging 
package, an Editor, a file utility package, 
etc. ; 

• performing input/output transfers at four dif- 
ferent levels, ranging from direct access of 
device drivers to full formatting capabilities, 
while providing the convenience of complete 
device independence; 

• providing a file system for management of 
secondary storage; and 

• providing a versatile set of keyboard commands 
for use in controlling the flow of programs. 


System programs and utilities can be called into core from 
disk, DECtape or magtape with Monitor commands issued directly 
at the keyboard. This feature eliminates the need to manipulate 




Convenient programming tool. 


DOS gives the user program the capability of complete device 
independence. Programs can be written without concern for specific 
I/O devices. When the program is run, the user can select the 
most effective or convenient I/O device available for the function 
to be performed. In addition, if the system configuration is 
altered, many programs can take advantage of the new configuration 
without being rewritten. Logical names can be assigned to devices 
T ( " ~ 

Available only on 12K or larger systems. The 8K assembler does not 
support macros . 
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within the system enabling symbolic referencing of any device. No 
concern need be given to I/O buffer size within the user program 
yet the user can alternatively retain direct control of I/O buffers. 

All input/output (I/O) transfers are handled by the Monitor in 
any of three user-selected levels called READ/WRITE, RECORD/BLOCK, 
and TRAN. READ/WRITE is a formatted level of I/O in which the user 
can specify any one of nine options. RECORD/BLOCK is a file-structured, 
random- access I/O level with no formatting. TRAN does basic I/O 
operations at the device driver level. All I/O is concurrent and 
interrupt driven. 

The file system on secondary storage uses two types of files: 
linked and contiguous. Linked files can grow serially and have no 
logical limit on their size. Contiguous files must have their 
lengths declared before use but can be randomly accessed by RECORD 
or BLOCK level I/O requests. All blocks in a contiguous file are 
physically adjacent, while blocks in a linked file are typically 
not adjacent (the first word of each block contains the address of 
the next block). Files can be deleted or created at any time, and 
are referenced by name. Table 1-1 summarizes the features and 
benefits of the DOS Monitor. 

The user communicates with the Monitor in two ways : through 
keyboard instructions called commands , and through programmed 
instructions called requests . 

Keyboard commands enable the user to load and run programs; 
assign I/O devices or files; start or restart programs at specific 
addresses; modify the contents of memory locations; retrieve system 
information such as time of day and date; and dump core. Users 
with more than 8K of memory 1 can utilize programmed requests, 
which are macros assembled into the user's program and through 
which the user specifies the operation to be performed by the 
Monitor. Some programmed requests are used to access input/output 
transfer facilities, and to specify where the data is, where it is 
going, and what format it is in. In these cases the Monitor will 
take care of bringing drivers in from disk, performing the data 
transfer, and notifying the user of the status of the transfer. 

X 8K users must include the code generated by such an assembly (the 
assembly language expansion shown in Appendix E and in the explana- 
tion of each programmed request in Chapter 3) in their programs to 
utilize the Monitor functions. See the MACRO manual 
(DEC-ll-OMACA-A-D) for other differences in the 8K Assembler. 
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Table 1-1 


PDP-11 DOS Monitor 
Feature 

Files are catalogued in multi- 
level file directories. 

Files are referred to by name. 


Files can grow serially. 


Files can be as large as the 
storage device can accept. 

File storage is allocated dynam- 
ically on any bulk-storage 
device . 

Monitor subroutines can be 
swapped into core when needed. 
Routines need not permanently 
tie up an area of core. 


Monitor subroutines can be 
made permanently core resi- 
dent before or during run 
time . 

The Monitor is divided into 
logical modules. 


All I/O is interrupt-driven. 


Device independence. 


Devices are assigned to one 
or more datasets. 


Features and Benefits 

Benefits to User 

No file naming conflicts among 
users . 

Files do not have to be remem- 
bered by number. 

Files can be created even when 
their final size is not known. 

No logical limit on the size of 
files . 

Files can be deleted or created 
even at run time for maximum 
storage efficiency. 

Much more efficient use of core 
space for user programs. Free 
core expands and contracts as 
Monitor subroutines are used. 
Space can be reclaimed for user 
programs. The user can deter- 
mine which Monitor subroutines 
will be in core, and when. 

The user can tailor the Monitor 
for his particular needs. 


The user can easily and effi- 
ciently use the logical pieces 
of the Monitor for his own needs. 
He can also easily add his own 
specialized drivers to the sys- 
tem by following a simple set 
of rules, and still use the 
rest of the Monitor with these 
drivers . 

Such specialized equipment as 
communications modems and A/D 
converters which must be inter- 
rupt driven can be run under the 
Monitor. Several I/O calls can 
be handled concurrently. 

Any device can be specified by 
the user in his program, and 
another device can be substituted 
by him when his program is being 
run. 

The user may reassign a device 
which is used for one purpose 
(dataset) without changing its 
assignment for all other purposes 
(datasets) . 


1-3 



Other requests access Monitor facilities to query system variables 
such as time of day, date, and system status, and to specify special 
functions for devices. 

Programs supported by DOS, and hence accessible through the 
Monitor, are listed in Table 1-2. 


Table 1-2 


Principal DOS System Programs 


System Program 

FORTRAN IV 
MACRO-11 Assembler 
EDIT-11 Text Editor 
0DT-11R Debugging Program 
PIP, File Utility Package 
Link-11 Linker and Libr-11 


Document Number 


DEC-ll-LFIVA-A-D 
DEC-1 1-OMACA-A-D 
DEC-ll-EEDA-D 
DEC-11-00DA-D 
DEC-ll-UPUPA-A-D 
ian DEC-ll-ULLMA-A-D 


1.2 MONITOR CORE ORGANIZATION 


Core memory is divided into: 


• a user area where user programs are located; 

• the stack where parameters are stored tempd*- 
rarily during the transfer of control between 
routines ; 

• the free core or buffer area which is divided 
into 16-word blocks assigned by the Monitor 
for temporary tables, for Monitor routines 
called in from disk, and for data buffering 
between devices and user programs; 

o the resident Monitor itself which includes 

all permanently resident routines and tables; 

• The interrupt vectors. 


Figure 1-1 is a map of core as organized by the Monitor. 

The DOS Monitor dynamically acquires and releases core on the 
basis of system requirements. 
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Figure 1-1 The Monitor Core Map 




1.3 HARDWARE CONFIGURATIONS 


Many minimum hardware configurations for use by the disk opera- 
ting system may be derived by choosing one item from each of the 
five following sets. 


9 PDP-11 System Building Block with 900 nsec. Core Memory 
and a Terminal (DECwriter [LA30] , Alphanumeric CRT 
[VT05-B] , or Teletype 1 [LT33]). 

• Cabinets and all Mounting Hardware. 

9 Bootstrap Loader (BM792-YB or MR-11) . 

m Choice of Disks (Control Logic Included) 

64K word Fixed Head Disk (RS64/RC11) 

256K word Fixed Head Disk (RF11/RS11) 

1.2 word Interchangeable Cartridge Disk (RK05/RK11) 

9 Choice of Tape Devices (Control Logic Included) 

Dual Drive DECtape (TU56/TC11) 

7- or 9-track Industry Standard Magnetic Tape (TU10/TM11) 
High-Speed Paper Tape Reader/Punch (PC11) 


Specific details are available from a sales representative. Note 
that 12K of core is required with the RK disk and DECtape is required 
with the RC disk. 


1.4 MONITOR MESSAGE 


When a message-producing situation (such as a system error) 
occurs, an error code and an additional word of information are dis- 
played on the teleprinter. There are five types of messages: 

» Informational 

9 Action required by the operator 

9 Warning to the operator 

9 Fatal 

9 System Program error 


The type of message is identified by being preceded by the letter 
I, A, W, F or S respectively. If the system disk should fail and 
the error message cannot be brought into core, the Monitor halts. 

Monitor messages are described in detail in Appendix F. 
teletype is a registered trademark of the Teletype Corporation. 
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1.5 STARTING THE MONITOR 


The Monitor is called into core from disk by performing the 
following procedure for systems with the BM792YB: 


1. If the system device is an RK11 Disk, turn WRITE 
ENABLE off; 

sC. • ixiove nALij.*/ Swi ucn uG iiiUj'-L pcsiuion / 

3. Load the processor switch register with 173100; 

4. Depress LOAD ADDRESS processor switch; 

5. Load the switch register with, 

177462 if the system device is RF11 disk, 

177406 if the system device is RK11 disk, 

177450 if the system device is RC11 disk; 

6. Move HALT/ENABLE processor switch to ENABLE position; 

7. Depress START processor switch. 


With the MRll Bootstrap Loader, the procedure is: 


1. Load the processor switch register with: 

173100 if the Monitor storage device is RF11 disk, 
173110 if the Monitor storage device is RK11 disk, 

2. Move HALT/ENABLE switch to HALT position; 

3. Move HALT/ENABLE switch to ENABLE position; 

4. Depress LOAD ADDRESS processor switch; 

5. Depress START processor switch. 

r TTh d Mr>r» i f nr wi 1 1 1 -5r»+-r> r*r> b>r>r} -i i fu i f col -F ty y~ i n- hi nrr 

DOS Vxx 


on the teleprinter, where Vxx represents the version number of the 
Monitor being used. The Monitor is now ready to accept an operator 
command (see Chapter 2). 
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1.6 A GUIDE TO THIS HANDBOOK 


1.6.1 Terminology 

The reader should understand the following terms as they apply 
to the PDP-11 Disk Operating System. An expanded Glossary, with 
abbreviations , can be found in Appendix I . 

A dataset is a logical collection of data which is treated as 
an entity by a program. Typically, the items in a dataset have 
a realtionship to each other which simultaneously binds them to- 
gether and distinguishes them from items in other datasets. For 
example, the records in the Object dataset produced by the assembler 
are clearly related to each other and are clearly distinct from the 
listing dataset produced by the same assembler. A parameter file 
and a source file, when presented successively to the assembler, 
might be viewed as a single dataset, however. 

Typically, each dataset is associated with exactly one link 
block (see section 3. 8. 6.1), although a link block can be associ- 
ated (successively, not simultaneously) with more than one dataset. 
For example, when the assembler finishes processing one dataset 
and returns for another command, the new input will constitute a 
new dataset, but the same link block will be used. 

Examples of datasets are: 

• all or part of a file on a file-structured 
device ; 

• one or more paper tapes in a paper tape reader; 

• a deck of cards, terminated by an EOF card; 

o three lines of keyboard data, a disk file, 

and a paper tape; which are read in sequence 
by the assembler and are viewed as the source 
input dataset. 

A device is any PDP-11 peripheral supported by the Monitor. 

A device controller can support one or more device units . 

A file is a physical collection of data which resides on a 
directory device (e.g., disk or DECtape) and is referenced by its 
name. A file occupies one or more blocks on a directory device. 
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On a directory device it is possible to store data by name, rather 
than simply physical location; it is also called a file-structured 
device . 

Bulk storage devices containing directories are called direc - 
tory devices or file-structured devices . Devices such as paper 
tape equipment and the teleprinter, which cannot support a file 

devices . 


A block is a group of adjacent words of a specified size on 
a device; it is the smallest system- addressable segment on the 
device. If the blocks comprising a file are physically adjacent 
to each other, the file is said to be contiguous ; if the blocks 
of the file are not physically adjacent, the file is said to be 
linked . 

A line is a string of ASCII 1 characters which is terminated by 
a LINE FEED, FORM FEED or VERTICAL TAB. 

File structure refers to the manner in which files are organ- 
ized. Specifically, each of a user's files is given a unique name 
by the user. Each user on a file-structured device is assigned a 
User File Directory (UFD) in which each of his files is listed by 
name and location. Each UFD is then listed in a Master File Direc- 
tory (MFD) which is unique to a specific device unit. 

1.6.2 Standards for Tables 


A table is a collection of data stored in sequential memory 
locations. A typical table as represented in this manual is shown 
below. This table is two words long, and is referenced by the sym- 
bolic address TABL:. The first entry is at location TABL and con- 
tains ENTRY A, which might be coded as .WORD AYE in the user's pro- 
gram. The second word of the table, at address TABL+2 , is divided 
into two bytes. The low-order byte (address TABL+2) contains ENTRY 
B, and the high-order byte (address TABL+3) contains ENTRY C. They 
might be written into a program as .BYTE BEE, CEE. 

X ASCII represents American Standard Code for Information Interchange. 
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a) Representation in manual 



b) Representation in program listing: 

TABL : .WORD AYE ; ENTRY A 

.BYTE BEE, CEE ; ENTRY B, ENTRY C 

Note that the first byte specified is stored at the rightmost avail- 
able byte. 

1.6.3 Standards for Numbers 

Unless otherwise stated, all numbers in the text and examples 
are in octal form. 
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CHAPTER 2 

MONITOR KEYBOARD COMMANDS 


2.1 INTRODUCTION 

Tin s Chapter snows now tne uisk upcrdtin^ ty s teiu v-tut ) r-ionitoir 
looks to the user as he sits at the terminal (i.e., the Teletype, 
DECwriter, etc. ) . The user is communicating with the DOS Monitor 
while running system, utility, and user programs. 

Since DOS is an interactive operating system, the primary input 
and output device is the user's terminal or teleprinter (keyboard 
and printer). Through the terminal keyboard, the user can communi- 
cate with 


• the Monitor, 

• a system or utility program (Macro, PIP, Editor, 
etc. ) , or 

• a user program written to run under DOS. 

The terminal printer is used to record user input and system output. 

In communicating with the Monitor, the keyboard is used as a 
control device to allocate system resources, move programs into 
core, start and stop programs, and exchange information with the 
system. Data from the keyboard may be transferred to a buffer in 
the user program or it may be processed immediately by the DOS 
Command String Interpreter (CSI) as explained in Appendix I. In 
this Chapter, the CSI is described only as it applies to the format- 
ting of Monitor keyboard commands . 

When the system is ready for input from the keyboard, a 
single character is printed on the teleprinter. The following con- 
ventions apply: 
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Character 


$ 


# 


* 

In this Chapter, we are concerned only with the $ and . characters. 
The # and * characters are explained in the individual system and 
utility programmer's manuals. 

The $ and . indicate that the Monitor is waiting for a keyboard 
command from the user. Note, however, that some commands may be 
issued only to a $ and some only to a . , and that each command has 
different limitations; these are discussed with each command in 
Section 2.8. 

2.1.1 Monitor Commands by Function 

A number of keyboard commands are provided for communication 
with the DOS Monitor. These commands are briefly identified by 
function in Table 2-1 and are fully described in Section 2.8. 


Meaning 


The system is idle, waiting for a Monitor com- 
mand. 

The Monitor is waiting to continue or abort a 
task . 

A system, utility, or user's program requests 
a command through the CSI. 


v A 

f? 


A system program requests direct input, i.e., 
not through the CSI. 


Table 2-1 

Monitor Commands by Function 


Function Command 

Establish identity of user LOGIN 

Terminate a session before leaving the system FINISH 

Enter or retrieve date DATE 

Enter or retrieve the time-of-day TIME 

Load and execute a program RUN 

Load a program GET 

Start a program which has been loaded BEGIN 

Resume a program that is waiting for user action CONTINUE 


(continued on next page) 
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Table 2-1 (Cont'd) 


Monitor Commands by Function 


Function 


Command 


Assign an I/O device or a file at run— time ASSIGN 

Inspect or modifv individual memory locations MODIFY 

Save a program in core for later use SAVE 

Dump memory data on the teleprinter DUMP 

Suppress or resume echoing of keyboard input ECHO 

Suppress or resume teleprinter output PRINT 

Start the program just loaded at its ODT entry point ODT 
Stop a program STOP 

Cneno^^ cs -v~ /-s /t >■* r* m T*7 7\ T rp 

-u Cuu -t 

Restart a program that has been running RESTART 

Terminate a keyboard or paper tape dataset END 


2.1.2 When Monitor Commands are Legal 

Each command performs a specific function, is legal to use 
under specific conditions, and often alters the state of the system, 
as shown in the following table. 


Command 


Legal When : 


State Induced 


ASSIGN 

BEGIN 

CONTINUE 

DATE 

DUMP 

ECHO 


any time 

program loaded and stopped 
program loaded and waiting 
any time 
any time 
program running 


no change 
program running 
program running 
no change 
no change 
no change 
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Command 

Legal When: 

State Induced 

END 

program running 


no change 

FINISH 

no program loaded 


logged out 

GET 

no program loaded 


program loaded and stopped 

KILL 

program loaded 


program stopped and unloaded 

LOGIN 

not logged in 


logged in 

MODIFY 

any time 


no change 

ODT 

program loaded and 

stopped 

program running under ODT 

PRINT 

program running 


no change 

RESTART 

program loaded and 

stopped/waiting 

program running 

RUN 

no program loaded 


program loaded and running 

SAVE 

program loaded and 

stopped 

no change 

STOP 

program running 


program stopped 

TIME 

any time 


no change 

WAIT 

program running 


program waiting 

A 

program is loaded if you have typed RUN 

or GET but not KILL, 

and as 

long as the program has 

not executed a . 

.EXIT call (see Chap- 


ter 3) . 


A program is running if you have typed RUN or if it has been 
loaded and you have typed BEGIN, CONTINUE, RESTART, or ODT . 

A program is loaded and stopped if GET but not BEGIN was typed, 
if it was running and a STOP was typed, or after issuing a fatal 
error message (see Appendix F) . 

A program is waiting if it was running and you typed CTRL/C 
followed by WAIT, or after the system issues an action error message 
(see Appendix F) . 

A program is stopped and unloaded (from core) if you have 
typed KILL or if the program issued an .EXIT call (see Chapter 3) . 


2 . 2 MONITOR MODE AND USER MODE 


From the user's point of view, his terminal is in either 
Monitor mode or user mode. In Monitor mode, each line the user 
types is sent to the Monitor's Command String Interpreter (CSI) . 

The execution of certain commands places the terminal in user mode. 
When the terminal is in user mode, it becomes simply an input/ 
output (I/O) device for that user. In addition, user programs use 
the terminal for two purposes: to accept user command strings (user 
mode) or as a direct I/O device (data mode) . 
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2 , 3 COMMAND STRING INTERPRETER (CSI) 


When the terminal is in Monitor mode the user communicates 
with the Monitor's Command String Interpreter (CSI). The commands 
described in this Chapter are processed by the CSI (see Appendix I) . 

The CSI makes several checks before processing commands from 
the user. For example, if a user who has not logged in types a 
command that requires him to be logged in, the system responds with 
the message: 

ILL CMD! 


meaning the command was illegal and was not executed. The commands 
discussed in this Chapter require that the user be logged in except 
where explicitly stated otherwise. When a command is issued that 
requires the job to use more core than is available, the system re- 
sponds with the message: 

NO CORE! 

and the user's command is not executed. 

All Monitor messages are shown in Appendix F. 

2.4 USER IDENTIFICATION CODE (UIC ) 

Each user of the system is normally assigned a User Identifi- 
cation Code (UIC) by the system or installation manager. The UIC 
is first used when logging in to the system, as explained in Sec- 
tion 2.7. The format of the UIC is: 

nnn ,nnn 

where nnn represents a string of two or three octal digits, from 
11 to 376 (0-10 and 377 are reserved for the system) . The value 
to the left of the comma represents the user-group number, while 
the value to the right represents the user's number within the 
group. 
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For example: 


67,123 


specifies user group 67 and user number 123. 


NOTE 

Except when logging in, the UIC is always de- 
limited by the left and right square brackets, 
as shown in the examples of various commands 
in this Chapter. 


2.5 FILENAMES AND FILENAME EXTENSIONS 


User program files are named with a certain convention, much 
the same as a person is named. For example, the first name is 
the filename and the second name is the filename extension. By 
convention, the filename and extension are separated by a period. 

For example: 

GEORGE. DOE 

could be a legal filename and extension. Note that the filename and 
extension cannot have embedded blanks (spaces) because a space will be 
interpreted as a delimiter, 

Filenames can consist of from one to six alphanumerics ; all 
after the sixth are ignored. The filename extension can consist 
of from one to three alphanumerics. The extension is generally 
used to indicate the type of information in the file. For example: 

Could be: 

a FORTRAN file named MAIN 
a Macro source file named SAMPLE 

a temporary file named TEST1 
a relocatable binary file named NAME 

A list of standard extensions are shown in Appendix 0 

User program files are identified by the filename . extension 
and the UIC - Thus, different users may use the same filename .exten- 
sion, and as long as they are created under different UIC's the 
files would remain distinct and separate. 


File 

MAIN . F4 

SAMPLE . MAC 
TEST1.TMP 
NAME . REL 
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2,6 SPECIAL KEYBOARD CHARACTERS 


There are several special keyboard characters recognized by 
the Monitor’s CSI that cause specific functions to be performed. 
These keyboard characters are explained below. 

2.6.1. The RETURN Kev 


The RETURN key is used to terminate a keyboard command and 
to advance the teleprinter paper one line. Typing the RETURN key 
produces a carriage return and line feed action on the teleprinter 

As characters are typed, they are transferred into a buffer 
where they are stored until the RETURN key (or another special 
keyboard character (s) ) is typed. When the RETURN key is typed, 
the data on that line is transferred to and processed by the CSI. 

All legal command strings are terminated by the RETURN key. 

2.6.2 The RUBOUT Key 

The RUBOUT key is used to correct typing errors. Typing the 
RUBOUT key once causes the last character typed to be deleted; 
typing it twice causes the last two characters to be deleted; etc. 
The Monitor prints the deleted characters delimited by backslashes 
For example, if you meant to type ASSIGN but typed ASIS instead, 
the error could be corrected by typing two RUBOUTs and then the 
correct characters. The printout would be: 

ASIS \ SI \ SIGN 

Notice that the deleted characters are shown in reverse order, 
i.e. , in the order in which they are deleted. 

2.6.3 The CTRL/C Keys 

The CTRL/C key combination is typed by holding down the CTRL 
key while typing the C key. When CTRL/C is typed, the Monitor is 
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alerted to accept a command from the keyboard. CTRL/C is echoed 
on the teleprinter as 1C, carriage return, line feed, and period. 

CTRL/C interrupts teleprinter output or keyboard input in a 
user program. Monitor action on a CTRL/C is not taken until any 
current Monitor command is completed because the keyboard interrupt 
is turned off. However, except for DUMP and MODIFY, it appears to 
the user that action on a CTRL/C is immediate. 

CTRL/C puts the Monitor in listening mode only. If it is 
desired to stop the function of the operating program, the STOP 
command should be used. 

If a second CTRL/C is typed before the RETURN key terminating 
a command, the input so far will be erased, a fresh 1C will be 
printed, and the Monitor will await a new command. 

2.6.4 The CTRL/U Keys 


The CTRL/U key combination is typed by holding down the CTRL 
key while typing the U key. When CTRL/U is typed, the line on 
which it is typed is deleted; the system responds with a carriage 
return and line feed so that the line (command) may be typed again. 

CTRL/U is echoed on the teleprinter as 1U, carriage return, 
and line feed. 

2.6.5 The Semicolon Key 

When the Monitor is in listening mode (i.e., following a 
CTRL/C), the semicolon (;) key causes subsequent characters on the 
line to be treated as a comment. It effectively puts the keyboard 
off-line so that all characters following the semicolon are printed 
on the teleprinter but no Monitor action is taken. 
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The ESCAPE key (ASCII 033 octal) may be used to pass special 
keyboard characters to a running user program. When the CSI de- 
tects the ESC key it passes the next character directly to the 
user program. The use of this feature is under programmer control. 

2.6.7 How Keyboard Characters are Processed 

As characters are typed they are stored in the keyboard buffer 
(about 85 characters capacity) pending termination of the line with 
a RETURN, CTRL/C, or CTRL/U, which transfers the line of characters 
to the Monitor buffer. 

When a RUBOUT is processed, it remains in the keyboard buffer 
and the character which it deletes is replaced with another RUBOUT. 
Since RUBOUTs are not removed until the line is transferred to the 
user, the capacity of the keyboard buffer may be exceeded if the 
sum of normal characters plus RUBOUTs is greater than 85. When 
this occurs, only RETURN, CTRL/C, or CTRL/U is accepted; all other 
characters are discarded and not echoed. This is done to maintain 
economy of core and to ensure that characters such as CTRL/C and 
CTRL/U can be processed correctly, even when they appear at the 
end of a very long line. 

CTRL/C and CTRL/U characters are processed immediately. 
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2.7 GETTING ON THE SYSTEM 


In order to gain access to the system, the user must log in 
with the LOGIN command (see section 2.8.11). First, ensure that 
the terminal is connected to the system (see Appendix H) . The 
LOGIN command is issued in response to the Monitor's $. If none 
exist on the teleprinter paper, type the RETURN key and a $ will 
be printed by the Monitor; if not, a new Monitor must be loaded 
as described in the Batch/DOS-11 System Manager's Guide. 

In response to $, the user should issue the LOGIN command 
with his User Identification Code (UIC) (see section 2.4). For 
example: 


$LOGIN 200 ,200 
DATE : - 20-OCT- 7 2 
TIME: -10: 41: 16 

£ 

NOTE 


In the examples, underscoring is used to designate 
system printout, whereas user input is not under- 
scored. 

In response to the LOGIN command, the Monitor prints the cur- 
rent calendar date and time-of-day followed by the $, indicating 
that the system is ready for a Monitor command from the user. 

Only one user can be logged in at a time. The LOGIN command 
will be rejected when it is given before the previous user has 
logged out with the FINISH command. 
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2. 8 MONITOR KEYBOARD COMMANDS 

A keyboard command to the Monitor consists of two parts: a 
command name and possibly one or more command arguments. A com- 
mand name is a string of two or more letters; all letters after 
the first two and up to a command name delimiter (space or comma) 
are ignored. 

Monitor keyboard commands are typed in response to a dollar 
sign ($) or a period (.), which is printed by the system. Gener- 
ally speaking, the $ indicates that the Monitor is waiting for a 
new task, and the . indicates that the Monitor is waiting to con- 
tinue or abort a previously assumed task. 

Although the commands are arranged in alphabetical order for 
ease of reference, they can be divided into functional groups for 
ease of learning. These groups with their associated commands 
are as follows: 

• Command to allocate system resources : 

ASSIGN 

• Commands to manipulate core images: 

RUN GET 

DUMP SAVE 

• Commands to start a program: 

BEGIN CONTINUE 

RESTART 

• Commands to stop a program: 

STOP WAIT 

KILL 

• Commands to exchange information with the system: 

DATE TIME 

LOGIN MODIFY 

FINISH 

• Miscellaneous commands: 

ECHO PRINT 

END ODT 
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The following conventions apply to all Monitor commands: 


• All commands are terminated with the RETURN key. 

• The command name is separated from its argu- 
ment (dataset specifier, etc. ) with a space. 

• All characters in a command are interpreted by 
the CSI; thus, no embedded blanks are allowed. 

• The UIC is always enclosed within square brackets, 
[ ] , except when used with the LOGIN command. 


The proper format for each command is given in the discussion 
of each command in this section. The following conventions apply 
to the command formats shown in this section. 


• Brackets [ ] are used to enclose optional elements 

• Braces { } are used to indicate that a choice must 
be made from the enclosed elements 

• The symbol A indicates that a space must appear there. 

• dev: refers to a device mnemonic (see Appendix A) . 

• dataset specifier may be represented by any portion 
of the expression: 

dev: filename . ext , [uic] 

where 


dev: 

is a legal device mnemonic and 
colon 

filename 

is a filename of up to six alpha- 
numerics 

. ext 

is a period and filename extension 
of up to three alphanumerics 

[uic] 

is the user's identification code 
in the form: 


[group no., user no.] 

• logical name is the name given by the user to the 

dataset in Link Block word LNKBLK+2 (see Chapter 3) . 


If for any reason a command cannot be executed satisfactorily, 
an appropriate message will be printed on the teleprinter and the 
command will be ignored. These messages are shown in Appendix F. 
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ASSIGN 


2.8.1 The ASSIGN Command 

Format: 


AS [SIGN] Adev: [dataset specifier, logical name] 


Purpose : 

This command assigns a physical device (and a filename when 
the device is file-structured) to the dataset identified by "logical 
name". The format of "dataset specifier" is: 

filenam. ext [uic] 

which designates the name, extension, and uic, if any, to be as- 
signed to the file. 

Any filename specified for a nonfile-structured device is 
ignored. 

Note that a device is assigned to a dataset, and that reas- 
signing it for one dataset does not reassign it for all datasets. 

The ASSIGN command overrides any assignment made in the pro- 
gram's internal control blocks (Link and Filename Blocks). The 
ASSIGN command is not needed if the program makes its own provi- 
sions for obtaining this information; e.g., by specifying defaults 
in its control blocks or by requesting a command string, as is done 
with the # symbol in the DOS system programs. 

An ASSIGN with no argumen t releases ( deassign ) all ASSIGNments 
previously made by the current user, i.e., since the last LOGIN 
command 

The ASSIGN command can be given at any time the Monitor is 
in core. Consider the following: 
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• If ASSIGN is given before a program is loaded, the 
device assignment will remain in effect until an- 
other ASSIGN is given with the same logical name 
or with no arguments, or until the Monitor itself 
is reloaded. ASSIGN, given at this time, enables 
the user to specify an assignment which will apply 
to several programs . 

• If ASSIGN is given after a program is loaded and 
before it has started running (i.e. , after a GET 
command) , the assignment will remain in effect as 
long as the program is in core, or until another 
ASSIGNment is performed. When the program disap- 
pears (by an .EXIT request or a KILL command) , the 
assignment is released. 

• ASSIGN may also be given after a program is running. 
For example , as a recovery from an 

A003 (device not ready) 

message, the user would do an ASSIGN followed by 
a CONTINUE. The assignment will remain in effect 
as long as the program is in core, or until the 
programmer reassigns the dataset, or until he re- 
starts the program with a BEGIN command. 

Doing an ASSIGN in this manner is provided for 
such emergency situations, but is not recommended 
as standard practice because it causes an extra 
buffer to be allocated from free core, and it will 
be effective only if the program has not already 
INITed the dataset to some other device. 
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BEGIN 


2.8.2 The BEGIN Command 

Format : 


BE [GIN] A [address] 


Purpose : 

The BEGIN command starts the execution of an already loaded 
program at the stated address. If no address is specified, the normal 
start address will be used. This command is valid only if a program 
is already in core. 

BEGIN is used after a GET, a STOP, or following a fatal error 
condition. The GET command followed by a BEGIN command is equiva- 
lent to a RUN command. If given after a program has been started, 
a BEGIN will restore core to the state which existed immediately 
after the program was loaded. It will rename all core allocations 
to buffers, device drivers, and assignments made dynamically, and 
the stack will be cleared before control is passed back to the pro- 
gram. If any files are under creation at this time, they will be 
deleted (see section 2.8.15). 

To start a program at its normal start address, type: 

BE 

To start a program at absolute address 3446, type: 

BEA3446 
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After a Program Crash : 


The BEGIN Command is provided not only as a means of starting 
a program loaded by GET but also to enable the user to try again 
after a program crash, hopefully with a clean slate. At the time 
of the crash, the program may already have opened but not closed 
output files and the subsequent request to reopen after a restart 
could then lead to other failure because these files now exist. To 
prevent this, the BEGIN processor tries to delete the files, but not 
by the normal Monitor process since this could mean writing out bit- 
maps which are currently in core and must be suspect because of the 
crash. Instead, it merely removes the names of the files from the 
appropriate device directory, and if these are on disk, unlinks any 
blocks so far allocated; for safety it does not touch the bit-maps 
already stored on the device. In almost all cases, this procedure 
suffices. However, the following implications should be noted. 


1. This automatic deletion by BEGIN will not suit a 
user who has already amassed considerable data in 
one of his output files and cannot replace it if 
he starts over. In this case, KILLing the program 
to save his data under a different filename might 
be a more appropriate action. However, he should 
then realize that he might be transmitting the ef- 
fects of his program failure to the device concerned. 

2. It is possible that by the time of the crash the 
program may have produced a fairly long file. On 

a DECtape for which there is only one bit-map, this 
is no problem. A disk, however, requires several 
bit-maps and the allocation of some of the blocks 
for the file may already be permanently recorded 
because the appropriate bit-map has been filled and 
has been replaced in core by another. Since BEGIN 
does not change the maps, these blocks will not be 
freed for further use. A series of situations such 
as this can, after a time, result in the disk becom- 
ing full even though the known files are not seen to 
occupy the whole capacity. The user should in this 
case consider whether or not he should chance disk- 
corruption and use KILL rather than BEGIN, The user 
can then delete the file by using PIP-11 to avoid the 
build-up of the nonavailable blocks described. 
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3. 


Some programs cannot be restarted with BEGIN (i.e., 
after having been started, they cannot be restarted 
with BEGIN.) A FORTRAN program is an example. In 
general, a program must be self “initialized if BEGIN 
is to be used in this way. Also, since the Monitor 
will try to clean up core and delete files, reBEGIN- 
ning a program which was badly out of control may 
lead to undesirable results. Thus, use BEGIN only 
if there is no other alternative. 
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CONTINUE 


2.8.3 The CONTINUE Command 


Format: 


CONTINUE] 


Purpose : 


This command is used after a WAIT command or a recoverable error 
condition (operator action message) to resume program operation at 
the point where it was interrupted. 

CONTINUE is valid only if a program is already in core. 
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DATE 


2.8.4 The DATE Command 

Format : 


DA[TE] A [date] 


Purpose : 

The DATE command may be used to obtain the current calendar 
date and to enter a date value from the keyboard; the date is 
printed in the dd-mmm-yy format. 

To obtain the current calendar date, simply type the DATE 
command followed by the RETURN key. For example: 

$DATE 

20-OCT-72 

$ 

The current calendar date is entered by the system or installation 
manager, and need not be reentered except when loading a new DOS 
Monitor. 

To enter a date value from the keyboard, type the DATE 
command, the desired date value, and then the RETURN key. 

For example: 

$DATE A dd-mmm-yy 

putting the desired date value in place of dd-mmm-yy. The entered 
date value is returned in response to subsequent DATE commands 
until another date is given. If the desired date value is 
an invalid date, e.g., 42-BOB-A1, subsequent responses to DATE 
will be meaningless, e.g., 00-XXX-YY . 

DATE is valid at any time. 
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DUMP 


2.8.5 The DUMP Command 


Format : 


DU[MP]AlP: [0] 


Purpose ; 


~ 

start addr 

" 


0 


_ 




[,end addr] 


The DUMP command is used to print on the Line Printer an abso- 
lute copy of the contents of the specified core area, formatted in 
octal. The core image is not altered. 


The argument 0 specifies the dump to be output from core. An 
0 is assumed on default, but the comma is required. 

The argument 0 is assumed if no "start address" is specified 
and the highest word in core is assumed if no "end address" is speci- 
fied. 


DUMP is valid at any time. If given while a program is run- 
ning, the operation of the program will be suspended for the time 
required to effect the dump. 

The syntax of the DUMP command was chosen to facilitate later 
expansion and flexibility of the command. 
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ECHO 


2.8.6 The ECHO Command 

Format: 


EC [HO] 


Purpose : 

The ECHO command may be used to suppress and restore keyboard 
echo, i.e., characters typed by the user will not appear on the 
terminal printer. A subsequent ECHO command turns the echo feature 
on again. The teleprinter as an output device for the program or 
the Monitor is not affected by this command. 

ECHO is valid only when a program is running in core and using 
the keyboard as an input device. 
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END 


2.8.7 The END Command 


Format: 


EN [D] A 



Purpose: 

The END command is used to terminate using the console as an 
input device , i.e. , the keyboard or low-speed paper tape reader. 
The command tells the Monitor "there is no more input from the 
device". The command effectively generates an end-of-file (EOF) 
from the keyboard. 

When no device is specified in the command, KB is assumed. 
The following actions are required with this command 

1. Type CTRL/C to obtain the Monitor's attention. 

Since the console is being used for program input 
(data mode) , the Monitor is not expecting a com- 
mand. 

2. Issue the END command (with appropriate argument). 

3. Type the RETURN key twice; yes, two RETURNS. The 
two RETURNS are required to return to the Monitor. 

For example: (where tC = CTRL/C, and (CR) = RETURN) 

+ C 

_;_END , KB (CR) (CR) 

END is valid only when the console is being used as an input 
device. 
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FINISH 


2.8.8 The FINISH Command 


FI [NISH] 


Purpose : 

The FINISH command informs the Monitor that the current user 
is leaving the system. The Monitor deletes all files which are 
not protected against automatic deletion on FINISH (see Section 
3. 9. 2. 2), and a new copy of the resident Monitor is "booted" into 
core. 


FINISH is valid only when no user program is in core. There- 
fore, unless the last character on the teleprinter is a $ , the 
user should precede a FINISH with CTRL/C followed by KILL. For 
example, the printout might be: 

+ C 

^KILL 

^FINISH 

TIME : -16 : 42 : 00 

MONITOR VJ38-02 

$ 

In response to a FINISH, the Monitor prints the time and then the 
newly booted Monitor identifies itself. The system is now ready 
for a user to log in. 
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GET 


2.8.9 The GET Command 

Format : 


GE [T] A dataset specifier 


Purpose : 

The GET command loads the specified file from the specified 
device. When a device is not specified, the system device is as- 
sumed. 

GET is valid only when no program is in core. 

The user should use a BEGIN or ODT command to commence exe- 
cution. 
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KILL 


2.8.10 The KILL Command 


KI [ 11 ] 


Purpose: 

The KILL command stops the execution of the current program 
after closing ail open files and completing any outstanding I/O. 
It then removes the program from core by returning control to 
the Monitor. 

KILL is valid only when a program is in core. 

To resume operations, the user must reload the program or 
load another with RUN or GET. 
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LOGIN 


2.8.11 The LOGIN Command 

Format : 


LO [GIN] Auic 


Purpose: 

The LOGIN command enables a user to gain access to the system. 
LOGIN requires a UIC as its argument (see section 2.4). The UIC 
indicates which directory (of several possible) , on each file- 
structured device, will be directly available to the user. 

Here the UIC is not enclosed within the square brackets; its 
format is simply 
nnn,nnn 

specifying group, user numbers respectively. 

LOGIN is valid only when there is no program loaded in core 
and provided no user has logged in and not logged out (FINISHed) . 
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MODIFY 


2.8.12 The MODIFY Command 

Format; 


MO [DIFY] A octal address 

octal address/contents: [new contents] 


Purpose : 

This command allows the user to display and make changes to the 
contents of the absolute memory location specified by "octal address" 
in the command line. When the RETURN key is typed at the end of the 
command line, the system responds by printing the contents of that 
address. At this point, the user can type one of the following 
( (CR) = RETURN key; (LF) = LINE FEED key): 

(CR) will leave the contents unmodified. 

new contents (CR) will change contents to new contents. 

(LF) will take similar action as CR and 

then automatically print the contents 
of the next memory location. 

To change the contents of location 40000: 

$MODIFYA40000 (CR) 

40000/16406: 10406 (CR) 

Then to examine the contents of 40000: 

$MOA40000 (CR) 

40000/10406: (CR) 

To examine the contents of locations 40000 and 40002, the sequence 
would be: 


$MOA40000 (CR) 
40000/104060: (LF) 

40002/000003: 
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Entry of an address outside the available core memory as part 
of the original MODIFY command will cause an error, and the command 
will be rejected. 

MODIFY is valid at any time . 
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ODT 


2.8.13 The ODT Command 


Format : 


OD [T] A 



Purpose: 

The ODT command starts the execution of the 0DT-11R Debugging 
Program. The argument specifies which ODT start address is to be 
used: 


Argument 

(none) 


R 


K 


Starts at 
START+0 

START +2 


START +4 


Action 


Clears ODT breakpoint table with- 
out resetting breakpoints. 

Clears ODT breakpoint table after 
replacing old instructions at 
breakpoints . 

Leaves breakpoints exactly as 
they are. 


This command begins execution at the ODT entry point of the 
user's load module. The user must have linked 0DT-11R with his 
program and must have identified his program to the Linker with 
the /OD switch. 

To reset all breakpoint locations at their former instruc- 
tions and restart ODT, the user would type: 

jddar 

ODT is valid only when 0DT-11R is linked to a program and 
both are in core. 
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PRINT 


2.8.14 The PRINT Command 

Format: 


PR [ INT] 


Purpose: 

The PRINT command may be used to suppress and restore tele- 
printer printing when the printer is used as an output device to 
a user program. A subsequent PRINT command turns the printing 
feature on again. 

PRINT is valid only when a program is running in core and is 
using the teleprinter as an output device. 
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RESTART 


2.8.15 The RESTART Command 


Format: 


RE [START] A [address] 


Purpose: 

The RESTART command permits a program to be restarted. As shown, 

the user may optionally supply an address at which the program is to 

be restarted. If no address is specified, the address set by the 
.RESTART programmed request is assumed if a .RSTRT request has 
been issued by the program (see Section 3. 8. 3. 2). 

If neither address is specified, the command is rejected. 

RESTART is valid only when a program is already in core. 

Before the program is restarted, the stack is cleared, any 
current I/O is stopped, and all internal busy states are removed. 
Buffers and device drivers set up for I/O operations will, how- 
ever, remain linked to the program for future use. 
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RUN 


2.8.16 The RUN Command 

Format: 


RU[N] A dataset specifier 


Purpose: 


The RUN command loads into core the specified program from the 
specified device and starts its execution at the normal start ad- 
dress. RUN is equivalent to a GET command followed by a BEGIN com- 
mand. 


The dataset specifier is of the form: 


dev: f ilenam.ext [uic] 


When no device is specified, the system device (disk) is assumed. 

The sequence in which the Monitor performs its search for the 
specified program depends on the existence and type of filename ex- 
tension and on the UIC. Various forms of the RUN command are shown 
below with the search sequence performed by the Monitor. 


• RUNAFILE 

Attempt 1 — FILE . LDA [current uic] 
Attempt 2 — FILE. LDA [1,1] 

Attempt 3 — FILE [current uic] 
Attempt 4 — FILE [1,1] 


RUNAFILE .EXT 

Attempt 1 -- FILE. EXT [current uic] 
Attempt 2 -- FILE. EXT [1,1] 
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• RUN AF ILE [ x , x ] 

Attempt 1 -- FILE.LDA [x,x] 

Attempt 2 — FILE [x,x] 

• RUNAFILE . EXT [x, x] 

Attempt 1 -- FILE. EXT [x,x] 

If all attempts fail to find the file, a NO FILE message is printed 
on the teleprinter. 

Searching for the LDA extension first exploits the fact that 
both the Linker and the SAVE command produce LDA extensions, unless 
the user specifies otherwise. 

RUN is valid only when there is no program in core. 
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SAVE 


2.8.17 The SAVE Command 


Format: 


SA [VE] A [dataset specifier] [/RA: low: high] 


Purpose: 

The SAVE command writes the program in core onto the device in 
loader format. The core image is not altered. SAVE is valid only 
when a program is in core but not running, i.e., immediately after 
loading with a GET command or after being halted by either a STOP 
command or a fatal error. 

If no dataset specifier is given, the SAVE processor will 
automatically set up a file called SAVE . LDA on the system disk 
after it has deleted any current file of the same name. If the 
user wishes to retain the current file, he must first rename it 
using PIP-11. If the dataset specifier is given, the file named 
must not already exist or the command will be rejected. System 
disk is assumed by default if the dataset specifier contains only 
a filename. When the filename is specified, the extension should 
also be specified. 

Normally it is expected that the user will only wish to save 
his program area. If this is the case, the range need not be 
given and the new file will begin from the program's low limit and 
extend to the top of core. If any other area is to be saved, the 
user should include the following at the end of the command: 

/RA: low: high 

where /RA is the range switch, and low and high define the limits 
required (each being valid octal word-bound addresses) . The saved 
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image will be preceded by the same communication information as 
that for the original program loaded, except that any information 
about the resident EMT modules will be lost. 

The SAVE processor will endeavor to get an extra 256-word 
buffer in order to satisfy the command. If this request cannot 
be granted because of insufficient free core, the command will 
be rejected. The user is therefore advised to use this facility 
only after he has released any datasets currently established. 

Once the SAVE command has been syntactically verified, any 
errors will be handled by the SAVE processor, which will print 
a relevant message and return to Monitor listening mode: 

DEVICE FULL End of output medium reached 

FILE ERROR xxx File structures error as indi- 
cated by xxx = file status byte 
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STOP 


2.8.18 The STOP Command 

Format: 


ST [OP] 


Purpose : 

This is an emergency command to stop the program and to 
abort any I/O in progress (by doing a hardware reset) . The pro- 
gram may be resumed with either the BEGIN or RESTART command. 

STOP is valid only if a program is in core. 

STOP differs from KILL in that KILL terminates the program 
in an orderly manner and removes the program from core. 
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TIME 


2.8.19 The TIME Command 


Format: 


TI [ME] A [time] 


Purpose : 

The TIME command may be used to obtain the current time-of- 

day and to enter a time value from the keyboard. The time 
is printed in the following format. 

hh:mm: ss 

meaning hours : minutes : seconds . 

To obtain the current time-of-day , simply type the TIME 
command followed by the RETURN key. For example: 

$TIME 

10:43:27 

$ 

The current time-of-day is entered by the system or installation 
manager, and need not be reentered except when loading a new DOS 
Monitor. 
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the desired time value, and then the RETURN key. 

For example: 

$TIME A hh :mm: ss 

putting the desired time value in place of hh:mm:ss. The entered 
time value is returned in response to subsequent TIME commands 
until another time value is given. 

TIME is valid at any time. 
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WAIT 


2.8.20 The WAIT Command 

Format: 


WA [ IT] 


Purpose: 

The WAIT command suspends the current program and allows any 
I/O in progress to finish. The program may be resumed with either 
the CONTINUE or RESTART command. 

WAIT is valid only if a program is in core. 
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CHAPTER 3 
PROGRAMMED REQUESTS 


3.1 INTRODUCTION 

The Monitor provides a number of services which are available 
to any user or system program. The most prominent of these are 
input/output (I/O) services. Other services include directory manage- 
ment, retrieval and modification of system parameters, various con- 
version routines, and a command string interpreter. The I/O services 
provide for linkage to device drivers, access to files in the file 
structure, and transfer of data to or from each device. 

The user program calls for the services of the Monitor through 
programmed requests. Programmed requests are macro calls 1 which are 
assembled into the user program and interpreted by the Monitor at 
execution time. A programmed request consists of a macro call 
followed, when appropriate, by one or more arguments. For example: 

.WAIT #LNKBLK 

is a programmed request called .WAIT followed by an argument #LNKBLK. 
The macro request is expanded at assembly time by the MACRO Assembler 1 
into a sequence of instructions which trap to and pass the arguments 
to the appropriate Monitor service routine to carry out the specified 
function. The assembly language expansion for .WAIT #LNKBLK is: 

MOV #LNKBLK, - (SP ) 

EMT 1 

To use the macro call, it is necessary to tell the assembler 
that you want the system definition for the macro. This is accom- 
plished via the .MCALL assembler directive (Macro-11 Assembler Pro- 
grammer's Manual), e.g., 

M/"* 7\ T T T.7** T m 

• nunuu • i. 

which must appear in the source prior to the first use of .WAIT. When 
.MCALL is encountered, the MACRO Assembler will get the definition of 
.WAIT from the system macro file (SYSMAC.SML) which is searched for, 
first in the current user's disk area, then under user identification 
code [1,1] . 

The system macros will accept most addressing modes as arguments. 
They will detect and announce potentially troublesome (e.g. X(SP)) 
or unlikely (e.g. SP) modes to protect the user. 

1 Users with less than 12K of core cannot run MACRO and consequently 
must include the assembly language expansion of the programmed re- 
quest in their programs instead of the request itself. 


3-1 



All legal addressing modes will appear without alteration in 
the expansion. Since the monitor expects the address of the Link 
Block on top of the stack at .WAIT time, any of the following macro 
calls might be appropriate: 

.WAIT #LNKBLK 

.WAIT RJ8 ; ADDRESS OF LNKBLK 

; IS IN REGISTER R0 

.WAIT POINTR ; ADDRESS OF LNKBLK IS 

; IN MEMORY LOCATION POINTR 

Refer to the MACRO-11 Assembler Programmer's Manual (Order 
Number DEC-11-0MACA-A-D) for further details. 

The programmed request arguments are parameters or addresses of 
tables which contain the parameters of the request. These tables 
are part of the user program, and are described in detail in 
Figures 3-6 to 3-18. 
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Services which the Monitor makes available to the user through 
programmed requests* can be classified into three groups: 

• requests for input/output and related services 

• requests for directory management services 

• requests for miscellaneous services 

Table 3-1 summarizes the programmed requests available under the 
Monitor. Detailed descriptions of each request can be found in 
the sections cited in Table 3-1. 
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Table 3-1 

Summary of Monitor Requests 


Mnemonic 

Purpose 

Section 

1 

Requests for Input/Output and Related Services* 


• IN IT 

Associates a dataset with a device driver and 
sets up the initial linkage. 

3.6.1 

. RLSE 

Removes the linkage between a device driver and 
a dataset, and releases the driver. 

3.6.2 

.OPEN 

Opens a dataset. 

3.6.3 

.CLOSE 

Closes a dataset. 

3.6.4 

.READ 

Transfers data from a device to a user's line 
buffer. 

3.6.5 

.WRITE 

Transfers data from a user's line buffer to a 
device. 

3.6.6 

. RECRD 

Transfers one logical record of a file between 
a device and a user buffer. 

3.6.7 

. BLOCK 

Transfers one physical block of a file between 
device and a Monitor buffer. 

3.6.8 

.TRAN 

Transfers data between a device and a user 
buffer, independent of any file structure. 

3.6.9 

.WAIT 

Waits for completion of any action on a dataset. 

3.6.10 

• WAITR 

Checks for completion of any action on a dataset, 
and provides a transfer address for a busy return. 

3.6.11 

.SPEC 

Performs special device functions. 

3.6.12 

.STAT 

Obtains device characteristics. 

3.6.13 

t 

Requests for Directory Management Services* 


.ALLOC 

Allocates a contiguous file. 

3.7.1 

. DELET 

Deletes a file. 

3.7.2 

. RENAM 

Renames a file. Changes a protection code. 

3.7.3 

. APPND 

Appends one linked file to another. 

3.7.4 

.LOOK 

Searches the directory for a particular filename 
and returns information about the file. 

3.7.5 

.KEEP 

Protects a file against automatic deletion on 
FINISHing. 

3.7.6 

Requests for Miscellaneous Services* 


.RUN 

Loads programs and overlays. 

3. 8. 1.1 

.EXIT 

Returns control to the Monitor. 

3.8. 2.1 


(Continued on next page) 
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Table 3-1 

Summary of Monitor Requests (Cont.) 


Mnemonic 

Purpose 

Section 

.TRAP 

Sets interrupt vector for the TRAP instruction. 

3.8. 3.1 

. RSTRT 

Sets the address used by the RESTART command. 

3.8. 3. 2 

.CORE 

Obtains address of highest word in core memory. 

3.8.4. 1 

.MONR 

Obtains address of first word above the 
resident Monitor. 

3. 8. 4. 2 

.MONF 

Obtains address of first word above the 

Monitor's highest allocated free core buffer. 

3.8.4. 3 

.DATE 

Obtains the date. 

3. 8. 4. 4 

.TIME 

Obtains the time of day. 

3.8.4. 5 

•CVTDT 

Converts internal date or time to ASCII. 

3.8.4. 6 i 

i 

• GTUIC 

Gets current UIC. 

3.8.4. 7 | 

• SfSDV 

Gets Radix-50 name of the system device. 

3. 8. 4. 8 j 

.QTPLA 

Gets the current program load address. 

3. 8. 4. 9 j 

i • STPLA 

Sets the program low address. 

3.8.4.10 j 

j 

. GTCIL 

Gets the base disk address of the CIL. 

3.8.4.11 

•GTSTK 

Gets the current stack base address. 

3.8.4.12 

. STSTK 

Sets the current stack base address. 

3.8.4.13 

. STFPU 

Sets the floating point exception vector. 

3.8.4.14 

• RADPK 

Packs three ASCII characters into one Radix-50 
word. 

3.8. 5.1 

.RADUP 

Unpacks one Radix-50 word into three ASCII 
characters. 

3.8. 5. 2 

• D2BIN 

Converts five decimal ASCII characters into 
one binary word. 

■3 « c; 

0 0 w 

. BIN2D 

Converts one binary word into five decimal 

ASCII characters. 

3. 8. 5. 4 

• 02BIN 

Converts six octal ASCII characters into one 
binary word. 

3.8. 5. 5 

. BIN20 

Converts one binary word into six octal ASCII 
characters. 

3. 8. 5. 6 

.CSI1 

Condenses a command string and checks for 
proper syntax. 

! 

3. 8. 6.1 

. CSI2 

Interprets one command string dataset specifi- 
cation. 

3. 8. 6. 2 
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3.2.1 Requests for Input/Output and Related Services 

All user I/O is handled by programmed requests, which provide 
three different levels of transfer: 

• READ or WRITE 

• RECORD or BLOCK 

• TRAN 

Each level uses a sequence of requests to complete the transfer. 

Note the distinction between READ/WRITE, RECORD/BLOCK, and TRAN as 
names of transfer levels , and .READ, .WRITE, .RECRD, .BLOCK, and 
.TRAN as specific programmed requests within these levels. 

Requests for I/O related services perform special device 
functions (such as rewinding a tape) and obtain device character- 
istics from device status words. 

Each request related to I/O services is described in Section 3.6. 

3. 2. 1.1 READ or WRITE Level Requests - Most input and output 

is done at this level. Processing is sequential, in that each read 
or write is applied to the next record or line in the file. Records 
may be in either ASCII or binary mode, and a number of formats are 
handled by the monitor. Records may also be of variable length: 

ASCII records usually contain line terminators while formatted binary 
records contain byte counts. 

READ or WRITE I/O under the Monitor consists of transferring 
the contents of a dataset between a device and a line buffer via a 
buffer in the Monitor (Figure 3-la). A line buffer is an area set 
up by the user in his program, into which he (or the Monitor) places 
data for output (or input) . The line buffer is usually preceded 
by the line buffer header , in which the user specifies the size and 
location of the line buffer and the mode (format) of the data. 
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Figure 3-la The Transfer Path 

. INIT #LNKBLK 
MOV #FILBLK,Rj0 

.OPENI #LNKBLK , Rj3 

— ^ . READ #LNKBLK, #BUFHDR 

.WRITE #LNKBLK 

(Process Data) 


.CLOSE #LNKBLK 
. RLSE #LNKBLK 

LNKBLK: (entries) 

FILBLK: (entries) Tables in User's Program 

BUFHDR : (entries) 

Figure 3-lb Sequence of Requests for READ/WRITE 
Figure 3-1 .READ/. WRITE Input/Output Transfers 



; FOR OUTPUT, REPLACE .OPENI 
; WITH .OPENO 

; ADDRESS OF FILBLK IS IN Rj0 

; FOR OUTPUT, REPLACE .READ 
; WITH .WRITE 

; COULD BE REPLACED BY . WAITR 
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When using READ or WRITE one can specify nine different modes 
of transfer, in two categories: ASCII and Binary. Details are 
presented in Section 3.6.1 and Figure 3-11. 

ASCII Modes: Formatted ASCII Parity - Special 

Formatted ASCII Parity - Normal 
Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 
Unformatted ASCII Parity - Normal 
Unformatted ASCII Nonparity - Normal 

Binary Modes: Formatted Binary - Special 

Formatted Binary - Normal 
Unformatted Binary - Normal 

To implement a READ or WRITE transfer, the programmer follows 
the sequence of requests shown in Figure 3 -lb. First, the 
programmer associates the device with the dataset via the . INIT 
request. The argument of this request is the address of a table 
called the Link Block. Entries in this table specify the device 
involved in the approaching transfer so that the Monitor may 
eventually establish a link between that device and the dataset. 

The Link Block is described in detail in Figure 3-6. The .INIT 
request loads the appropriate device driver into the Monitor's 
free core area, if it is not already there. 

Following the .INIT request, the programmer opens a dataset with 
an .OPENx request. This need be done only if the device being used 
is a file-structured device. However, it is advisable to use an 
.OPENx even for a non-file-structured device to preserve the device 
independence of the program, since it may be desirable to assign 
the transfer to a file-structured device later. The arguments of 
this request are the address of the Link Block and a register into 
which the user has moved the address of a table called the Filename 
Block (Figure 3-7). Entries in this table describe the file 
involved in the transfer. 

A dataset can be opened for input, for output, for update, or 
for extension. The last letter of the .OPENx request specifies 
which type of open is desired. 

A .READ (for input) or a .WRITE (for output) follows the .OPENx. 
Either request causes a transfer to take place between the line 
buffer and the device via a buffer allocated by the Monitor in 
its free core area. The arguments of either request are the address 
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of the Link Block for the dataset and the address of the Line Buffer 
Header (Figure 3.9). The Line Buffer Header specifies the area 
in the user's core area to or from which the data is to be trans- 
ferred. During the transfer, the Monitor formats the data according 
to the transfer mode and formatting characters in the data itself. 

In most modes, terminating characters indicate the end of a line. 
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completion of the last transfer, and passes control to the next 
instruction when the transfer is complete. Typically, what follows 
a .WAIT on an input is a subroutine to process the portion of data 
just read. When the process has been completed, the program checks 
to see if there is more data; if there is, the program transfers 
control back to the .READ request and the process is repeated. If 
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complete any pending action, update any directories affected, and 
release to free core any buffer space the Monitor has allocated from 
free core for this dataset. Finally, action on the dataset is 
formally terminated with the . RLSE request, which disassociates the 
device from the dataset, and releases the driver. Releasing the 
driver frees core provided there is no other claim to the driver 
from another dataset. 
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3. 2. 1.2 RECORD Level Requests - The Record Level request is 
used for random access to the records in a file. A program which 
uses Read or Write Level requests can only read or write the next 
record in the dataset being processed. When Record Level requests 
are used, the program always has access to any record in the file. 

Record Level requests may be used only with file-structured 
devices and only with contiguous files (not with linked files). 

Each of the records in the file must contain the same numbers of 
bytes. No formatting is done and no line terminating characters 
are needed. The length of a record is independent of the block 
size of the device (may be the same or smaller or larger; neither 
record length nor block size need divide the other, but processing 
may be faster if this is arranged, since it can reduce the number 
of multi-block transfers) . 

Some consideration must be given to the manner in which a 
Record Level file is created. Perhaps the most common way to create 
such a file is by doing an .OPENC (after the file has been allocated) 

and using the .WRITE request to enter data. Unformatted ASCII and 
unformatted binary are the suggested transfer modes, since they 

do not require terminators and do not perform formatting; recall 
that all records must be the same length. When such a file is 
.CLOSED, a logical end-of-file is established following the last 
record written. Subsequent processing of the file by .READ 
or . RECRD will be confined to the area just written. At some 
later time, the file may be opened for extension (.OPENE) and more 
data can be written (.WRITE), provided the original space allocated 
to the file is sufficient to contain it. A second way to create a 
Record Level file is to start with .OPENU (again the file must have 
been allocated previously) and to use .RECRD to do the writing. In 
this mode, the logical end-of-file corresponds to the end of the 
allocated area) . Note also that, unless the program writes in every 
record of the file, that some records will be left with meaningless 
contents . 

Before issuing Record Level requests, the program must issue 
an . IN IT request to associate the dataset with a file-structured 
device. It must then open the dataset; .OPEN is not optional as 
with .READ and .WRITE. The dataset may be opened in two ways: 
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Request next 
record for 
update if 


. INIT #LNKBLK 
MOV #FILBLK, Rl 

.OPENU # LNKBLK, R1 
► . RECRD # LNKBLK , # RECBLK 
.WAIT # LNKBLK 

(Process Data) 

I 

.RECRD # LNKBLK, # RECBLK 
.WAIT # LNKBLK 


; INIT THE DATASET 

; OPEN THE FILE 
; INPUT THE RECORD 


; OUTPUT THE RECORD 


Yes/jyiore 


LNKBLK: 
FILBLK : 


CLOSE # LNKBLK 
, RLSE # LNKBLK 


Tables in User Program 


;CLOSE THE FILE 
; RELEASE THE DATASET 


Figure 3-2b Sequence of Requests for .RECRD 


Figure 3-2 .RECRD Input/Output Transfers. 
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• OPENU 


This mode is used if the program will write 
in the dataset. Reading is also permitted. 

In fact, quite often the program will read a 
record, update it, and write it back. 

• OPENI - This mode is used if no writing will be done. 

Only reading will be permitted. 

The dataset may then be processed using .RECRD requests. If 
updating is being done, there will generally be two such requests 
in each cycle. Otherwise, there will be only one. Each .RECRD 
request should be followed by a .WAIT (or .WAITR) request. When 
processing is completed, a .CLOSE request should be issued to 
ensure that the last record is actually written to the device (for 
output) and that the directory is updated (if necessary) . A . RLSE 
request is also required, so that the driver can be removed from 
core (if not still in use by another dataset) . The .RECRD request 
has a Link Block and a Record Block as arguments. The Record 
Block specifies function (input/output) , buffer address, record 
length, and record number (see Figure 3-12) . 

3. 2. 1.3. BLOCK Level Requests - The Block Level request is 
used for random access to the physical blocks in a file. The 
Block Level is similar to the Record Level. However, at the 
Block Level, each request always reads or writes exactly one 
physical block of data instead of a user-defined quantity of data, 
as is true at the Record Level. In addition, data transfer is to 
and from a buffer provided by the monitor, rather than a buffer 
provided by the user. The user may do his processing in the 
monitor buffer or he may transfer data to his own area. As with 
Record Level requests, Block Level requests may be used only with 
file-structured devices and only with linked files (ne»kv 4 a£i-feh- 
contiguous files) . 

To implement a BLOCK transfer, the programmer follows the 
sequence of requests shown in Figure 3-3b. Notice that the transfer 
must use . INIT, .OPEN, .WAIT, .CLOSE and .RLSE following the same 
rules as the READ or WRITE level. The .BLOCK request has the 
address of the Link Block and the BLOCK block for its arguments. 

The BLOCK block specifies the function (INPUT, GET, or OUTPUT) , 
the relative number of the block being transferred to or from, the 
Monitor buffer address (supplied by the Monitor), and the length of 
the Monitor buffer (supplied by the Monitor). See section 3.6.8. 
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.IN IT #LNKBLK 

MOV #FILBLK , Rl 

.OPENU #LNKBLK, Rl 

.BLOCK #LNKBLK , #BLKBLK ; INPUT DESIRED BLOCK 

.WAIT #LNKBLK ; COULD BE REPLACED BY . WAITR 

(Process Data) ; UPDATE DATA 

• BLOCK #LNKBLK , # BLKBLK ; WRITE UPDATED BLOCK 

•WAIT #LNKBLK 


.CLOSE #LNKBLK 
. RLSE #LNKBLK 
LNKBLK : (entries) 

FILBLK: (entries) 

BLKBLK: (entries) 

Figure 3-3b The Sequence of Requests For .BLOCK 



Figure 3-3 .BLOCK Input/Output Transfers 
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3. 2. 1.4 T RAN Level Requests - A TRAN level request is a basic 
input/output operation. No services are provided for the user other 
than to pass his request to the appropriate driver. .TRAN ignores 
any file-structure on the device. .TRAN does not operate within a 
particular file as do .READ, .WRITE, . RECRD , and .BLOCK; hence no 
.OPEN or .CLOSE is used. Because .TRAN does not respect file 
structures, the user is strongly cautioned against using it with 
file-structured devices, since he can easily do irreparable damage 
to information on such a device. Omitting the dataset name from the 
Link Block will prevent a file-structured device from being assigned. 

Data is transferred directly between the device and a buffer 
provided by the user (Figure 3-4a), with no formatting performed. 

.TRAN is generally used in 2 situations: 

1. When the file structure does not allow the desired 
operation (e.g. , PIP uses .TRAN to read a directory 

block for the directory listing operation) . 

2. When one does not need or cannot afford the over- 
head of doing READ/WRITE processing on a non-file 
structured device (e.g f a program to read data 
arriving at random intervals from an A/D converter 
might use .TRAN to read the data and .BLOCK to 
buffer the data on a disk for processing as time 
permits . 

To implement a TRAN transfer, the programmer follows the sequence 
of requests shown in Figure 3-4b. Notice that the transfer must 
use . INIT and . RLSE , but must not use .OPEN or .CLOSE. The .TRAN 
request has the address of the TRAN Control Block (TRNBLK) as its 
argument. This block contains entries which specify the core 
starting address of the user's buffer, the device block address, 
the number of words to be transferred, and the function to be 

performed. TRAN is therefore a device dependent request. 

Table 3-2 

Transfer Levels for Types of Datasets 


Type of Data 


Type of 

Transfer 

Linked 

File 

Contiguous 

File 

Non file-Structured 
Device 

READ /WRITE 

Yes 

Yes 

Yes 

RECORD 

No 

Yes 

No 

BLOCK 

No 

Yes 

No 

TRAN 

* 

* 

Yes 


* indicates that TRAN may be used on a file-structured 
device if the warnings mentioned are observed. Usage 
in these cases is not advised. 
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USER PROGRAM 


USER BUFFER 

f 


.TRAN output 


.TRAN input 


r 


DEVICE 


Figure 3-4a The Transfer Path 


. IN IT # LN KBLK "« •* 


> .TRAN #LNKBLK , #TRNBLK 

.WAIT #LNKBLK 
(Process Data) 

Yes 

. RLSE #LNKBLK 

LNKBLK: (entries) 



TRNBLK: 


(entries ) 


; COULD BE REPLACED BY . WAITR 


Tables and parameters 
in User Program 


Figure 3-4b The Sequence of Requests For .TRAN 


Figure 3-4 .TRAN Input/Output Transfers 
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3.2.2 Requests for Di-rectory Management Services 

Directory management requests are used to enter filenames into 
directories, search for files, update filenames, and protect files 
against deletion. 

Each directory management request is described in Section 3.7. 

3.2.3 Requests for Miscellaneous Services 

Requests for miscellaneous services include: 

• Requests to Load programs and overlays. 

• Requests to return control from a running program to 
the Monitor. 

• Requests to set Monitor parameters such as the TRAP 
vector or a program's restart address. 

• Requests to obtain Monitor parameters such as the size 
of the Monitor, the date, the time, and the current 
user's UIC. 

• Requests to perform conversions between ASCII and 
Radix-50 packed ASCII, binary and ASCII decimal, and 
binary and ASCII octal. 

• Requests to access the Command String Interpreter. 

Each miscellaneous service request is described in Section 3.8. 

3.3 DEVICE INDEPENDENCE 

It is generally preferable to write programs so that each 
dataset may be associated with the widest possible variety of 
devices. This makes it easier to move a program from one configura- 
tion to another. It also makes it possible to use the program with 
a variety of different media. For example, the Assembler accepts 
input from disk, paper tape, DECtape, and other devices. 

The monitor makes it relatively easy to achieve this objective. 
Most I/O operations are completely device independent (i.e., no 
special actions by the user are required to accommodate the opera- 
tion to the device, specifically .READ, .WRITE, .OPEN, .CLOSE, 

.WAIT, . WAITR, . INIT , and . RLSE. In addition, . RECRD and .BLOCK re- 
quire only that the device be file structured. Only .TRAN and .SPEC 
are typically device dependent. 

In all cases, no device is associated with a dataset until an 
.INIT request is made. The device name may be specified in any 
of the following ways: 

• the programmer may specify the name in his Link Block; 

• the program can obtain a device name by requesting the 
user to enter a command string (section 3.8.6); this will 
override any device specified in the Link Block; 
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• the user can use the ASSIGN command (see Chapter 2) 
to associate a device (and file name) with the data- 
set, this option overrides both preceding options. 

Note that when a command string is solicited by the program, it will 
always override the link block specification, no matter what is 
entered. However, when ASSIGN is not solicited but is entered 
at the operator's discretion, it will override the Link Block 
only when specified. In the latter case, it is best to supply 
a default in the Link Block. 

Note that the substituted devices must be compatible. For 
example, the user may initially specify a BLOCK transfer from disk 
and later change the assignment to input from DECtape instead. 

But, he cannot later specify a paper tape reader as the input 
device, since BLOCK level requests do not apply to nonfile- 
structured devices. 

It is important to note that a device is assigned in a program 
to a dataset logical name and that reassigning a device at run 
time for one dataset logical name does not reassign that device 
for all dataset logical names to which it was originally assigned. 

The only transfer requests which are not device independent 
are .TRAN and .SPEC. 

3. 4 SWAPPING ROUTINES INTO CORE 

Except for a small, permanently resident portion, the Monitor 
routines which process most programmed requests are potentially 
swappable. They are normally disk resident and are swapped into 
core by the Monitor only when needed. The user may, however, 
specify that one or more of these potentially swappable routines 
be made permanently core resident or core resident only for the 
duration of his program's run. 

Making a potentially swappable routine core resident ties up 
core space, but speeds up operation on the associated request. The 
user may, for example, be collecting data via a .TRAN request in a 
real-time environment. In such a case, even the short time needed 
to swap in the .TRAN request processor could cause him to lose data. 

Any routine which services a programmed request (other than 
•READ or .WRITE) may be made core resident by one of the following 
methods : 

• Routines may be made permanently core resident at 
Monitor Generation time (see the DOS System 
Manager's Guide). 
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• Routines may be made core resident for the duration 
of a program's run by declaring the appropriate 
global name (as specified in the definition of each 
request in Sections 3-6 through 3.8) in a .GLOBL 
assembler directive in the user program. For example, 
to make the . TRAIT processor resident while program 
FROP is being run, the following directive would be 
included in program FROP : 

.GLOBL TRA 

Device drivers are swapped into the Monitor's free core area 
on an . INIT call and are freed from core on the occurrence of a 
.RLSE, provided no other dataset is INITed to that device. 

3.5 MONITOR RESTRICTIONS ON THE PROGRAMMER 

In return for the services provided by the Monitor, the 
programmer must honor certain restrictions: 

• The programmer should not use either the EMT or the 
IOT instructions for communication within his program. 

• It is recommended that the user not raise his 
interrupt priority level above 3, since it might 
lock out a device that is currently trying to do 
input/output . 

• HALTS are not recommended. If a HALT is executed 
during an I/O operation, most devices will stop, 
and only recovery from the console (pressing the 
CONTinue switch on the console) will be effective 
(recovery from the keyboard will not be immediately 
possible, since a HALT inhibits the keyboard 
interrupt). Some devices, such as DECtape, will not 
see the HALT and will continue moving, will lose 
their positions over the block under transfer, and 
may even run the tape off the reel. 

• The RESET instruction should not be used because it 
forces a hardware reset; clearing all buffer registers, 
and status flags and disabling all interrupts, includ- 
ing keyboard interrupts. Since all I/O is interrupt 
driven, RESET will disable the system. 

• The user must not penetrate the Monitor when he is 
using the stack. The stack is set by the RUN time 
loader just below the lowest address of the program 
loaded. The Monitor checks to see that the stack is 
not overflowing each time it honors a request. 

• The user may allocate temporary storage areas on 
the stack by simply subtracting the size of the 
area needed from the current stack pointer value. 

When doing so, he should use a .MONF (Section 3 . 8 . 4 . 3) to 
determine the highest address being used by the 
Monitor. It is generally wise to leave some space 
for future Monitor expansion (as a consequence of 
programmed requests) and for stack extension (as a 
consequence of subroutine calls. Monitor requests, 
device interrupts, etc.). Consult Figure 3-5 for 
more information about monitor core usage. 
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• The user should be aware that certain requests, 
such as .IN IT, may change the amount of available 
free core, since the instructions may call in drivers 
and establish data blocks. Such requests affect the 
result of MONF requests. 

• Certain requests return data to the user on the stack. 
The user must clear the stack himself before the 
stack is used again. The Monitor clears the stack 
after it honors requests that do not return data to 
the user on the stack. 

• The user should not use global names that are 
listed in Appendix E. 

• The Link pointer in the Link Block is set by the 
Monitor and must not be altered by the user. 
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.INIT 

3 . 6 REQUEST FOR INPUT/OUTPUT SERVICES 

3.6.1 . INIT - Associate a dataset with a device driver and set up 

the initial linkage. 

Macro Call : .INIT #LNKBLK 

where LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV # LNKBLK, - (SP ) 

EMT 6 

Global Name : INR 

Description : Assigns a device to a dataset and assures that the 

appropriate driver exists and is in core. If the driver is not in 
core, it is loaded. The device assigned is that specified in the 
associated Link Block, unless assignment has been made to the logical 
name specified in the Link Block with the ASSIGN command or via the 
Command String Interpreter. After the .INIT has been completed, 
control is returned to the user at the instruction following the 
assembly language expansion. The argument is removed from the stack. 

Rules : The user must set up within his program a Link Block 

of the format explained in section 3.9.1 for each dataset to be 
INITed. A dataset which has been . INITed should be . RLSEd prior to 
any further .INIT request for any Link Block. 

Errors: A nonfatal error message, A003, is printed on the 

teleprinter if no assignment has been made through the ASSIGN command, 
and the DEFAULT DEVICE is either not specified in the Link Block or 
has been specified illegally (i.e., no such device on the system). 

The user may type in an assignment (ASSIGN) and give the CONTINUE 
console command to resume operation. 

Control is transferred to the address specified by the error 
return address in the Link Block if at any time during an operation 
there is not enough space in free core for the necessary drivers, 
buffers, or tables. If no address (i.e., a zero) is specified in the 
Link Block's ERROR RETURN ADDRESS, a fatal (F007) error is printed 
and the program stops. 

Example : (see .RLSE) . 
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.RLSE 

3.6.2 . RLSE - Remove the linkage between a device driver and a data- 

set and release the driver. 

Macro Call : .RLSE #LNKBLK 

where LNKBLK is the address of the Link Block previously INITed. 

Assembly Language Expansion : 

MOV # LNKBLK, - (SP) 

EMT 7 

Global Name : RLS 

Description : Dissociates the device from the dataset and releases 

the dataset's claim to the driver. Releasing the driver frees core 
provided no other dataset has claimed the driver, and provided that 
the driver is not permanently core resident. 


Rules : The device to be released must have been previously 

INITed to the dataset. 

If the dataset has been OPENed on a directory device, it must be 
CLOSEd before the device is released. On a nondirectory device, a 
.RLSE will ensure that any data remaining in the Monitor buffer for 
output is dispatched to the device and will return any buffer still 
associated with the dataset to free core. 

After the release has been completed, control is returned to the 
user at the instruction following the assembly language expansion; 
the argument is removed from the stack. 


Errors ; If the dataset has been OPENed to a file-structured 

device, a .RLSE not preceded by a .CLOSE will be treated as a fatal 
error, F005. A .RLSE error (F005) may also occur if the link pointer 
in the Link Block is invalid, indicating probable corruption of the 
Monitor or its control blocks. 


Example : 


LNKl : 


INIT 

#LNK1 

ASSOCIATE A DATASET WITH A DEVICE 

RLSE 

#LNK1 


WORD 

ERRl 

ERROR RETURN ADDRESS 

WORD 

0 

POINTER FOR MONITOR 

RAD 50 

/DSI/ 

LOGICAL NAME OF DATASET 

BYTE 

1,0 

DEVICE SPECIFIED, UNIT 

RAD 50 

/KB/ 

SPECIFY KEYBOARD 


ERRl : 


; ERROR PROCESSING LOGIC 



.OPEN 


3.6.3 .OPEN - Prepare a device (which has been .INITed) for data 
transfer and associate the dataset with a file (if the device is file- 
structured ) . 

Macro Call : .OPEN #LNKBLK, #FILBLK 

This form assumes that the File Block contains a code indicating how 
the file is to be opened (see Description below) . 

Assembly Language Expansion : 

MOV #FILBLK, - (SP) 

MOV #LNKBLK, - (SP) 

EMT 16 

Alternate Form of Macro Call : 

. OPENx #LNKBLK, Rn 

where Rn is a register containing the address of the File Block and 
x indicates the type of .OPEN (see Description below). 

Assembly Language Expansion : 

MOVB #CODE, -2 (Rn) (see Description below) 

MOV Rn, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 16 

Global Name : OPN (See Appendix C for subsidiary routines.) 

Description : When used, .OPEN follows . INIT or .CLOSE (if more than 

one file is to be opened on the same dataset) . When the device being 
used is file-structured, .OPEN associates a specific file with the 
dataset. .OPEN also acquires a data buffer and prepares the device 
or the file for the ensuing data transfers. See Appendix C for details 
about specific .OPEN actions for particular devices. .OPEN has five 
forms; the desired form may be specified by inserting the proper 
HOW OPEN code in the File Block (see Figure 3-7) or by selecting one 
of the alternate forms of the Macro Call. The different .OPEN forms 
are described below: 

HOW OPEN 
Form Code 

. OPENU 1 


.OPENO 2 


Description 

opens a previously created contiguous file 
for input and output by .RECRD or .BLOCK 
request; .OPENU is rejected if the device 
is not file-structured. 

a. creates a new linked file and prepares 
it for output via .WRITE; the file 
must not already exist. 

b. prepares a nonfile-structured device 
for output via .WRITE (see Appendix C) . 
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HOW OPEN 
Form Code 

. OPENE 3 


.OPEN I 4 


.OPENC 13 


.OPEN (cont) 

Description 

opens a previously created linked or con- 
tiguous file to make it longer via .WRITE; 
note that a contiguous file may only be 
extended within the area already allocated; 
although additional blocks may be added to 
a linked file, no additional blocks may be 
added to a contiguous file (see .CLOSE); 

J _ 1 -! "TJ TH XT />"\ -j -C 4- ^ ^ -j 

is not file-structured. 

a. opens a previously created linked or 
contiguous file for input via .READ, 

. RECRD , or .BLOCK. 

b. prepares a nonfile-structured device 
for input via .READ (see Appendix C) . 

opens a previously created contiguous file 
for output via .WRITE; when a contiguous 
file is first opened for writing (via 
.WRITE), .OPENC must be used; subsequent 
opens for output (via .WRITE) must be 
.OPENE' s; .OPENC is treated like .OPENO 
if the device is not file-structured. 


At this point, the user should note the difference between linked 
files and contiguous files. A linked file has records allocated to it 
one at a time, as they are needed. Each record in the file contains 
a pointer to its successor, the User File Directory (UFD) points to 
the first record. Because records are allocated as needed, the user 
need not concern himself at all with the size of the file nor with the 
allocation of any records. Furthermore, a linked file can easily be 
extended in the future. However, because records are scattered about 
on the disk and because the system must read all intermediate records 
to move from one record to another (forward only) , linked files can 
only be used for sequential processing (.READ or .WRITE). 

A contiguous file has all of its records allocated at once in a 
contiguous area of the disk which is reserved for the file. Since any 
record in the file can easily be located relative to the first record 
in the file, random (or direct) access (.RECRD or .BLOCK) is possible 
in addition to sequential access. However, it is now necessary to 
know in advance how much space will be needed, since no more space can 
be added later. Since this may be difficult, one often has to guess 
and space is often wasted. Note, however, that a contiguous file can 
be extended within the space already allocated, i.e., if the area was 
not filled when the file was first written (or extended) , more data 
can be added. Because the user is responsible for determining the 
size of a contiguous file, he is required to allocate it before open- 
ing it (compare .OPENC and .OPENO). This may be done with PIP, using 
the ALLOCATE command or with the .ALLOC programmed request. 
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.OPEN (cont) 


After the open request has been processed, control is returned to 
the user at the instruction following the assembly language expansion; 
the arguments are removed from the stack. At this time, however, the 
device concerned may still be completing operations required by the 
request. A summary of transfer requests which may legally follow 
.OPEN requests is illustrated in Table 3-3. 


Table 3-3 

Transfer Requests Which May Follow Open Requests 



Linked File 

Contiguous File 



Input 

Output 

Input 

Output 

File 
Already 
Exist ? 

Type of^^^t 
Open 

.READ 

.WRITE 

.READ 

. RECRD 
. BLOCK 

.WRITE 

. RECRD 
.BLOCK 

. OPENU 




Yes 


Yes 

Must 

. OPENO 


Yes 





Must Not 

.OPENE 


Yes 





Must 

.OPENI 

Yes 


Yes 

Yes 



Must 

. OPENC 





Yes 


Must 


Rules : a. General Rules for All .OPENx Requests - The user must 

set up a Filename Block in his program (see Figure 3-7) . If the 
dataset is a file, the Filename Block must contain a legal file- 
name (see Section 2.3). If the dataset is not a file, or if it 
will be specified by an .ASsign or via the Command String 
Interpreter, the Filename Block need not contain any FILENAME or 
EXTENSION entries. 

All datasets must have been INITed before they are OPENed. 
The .OPEN must be applicable to the type of device (e.g., .OPENI 
to the line printer is illegal) . 

For datasets on directory devices, the User Identification 
Code (UIC) in the Filename Block (if specified) must be in the 
directory of the device. If the UIC is not specified, the user 
must have logged in with a UIC that appears on the device. 

The .OPENx request must not violate the protect code of the 
file. 

If a dataset is opened for any output, it cannot be opened 
again until it has been closed. 
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.OPEN (cont) 

b. Rules for .OPENO - The .OPENO request is applicable 
only for outputs to nonfile-structured devices or to a linked 
file on a file-structured device. It is not applicable to con- 
tiguous files. 

The .OPENO request creates a linked file on a directory device 

4 *p 1 *| -i 4- p.qy'v'po T-xy-x y*i y> Tp A ~J y\ grv*. ri T5 1 

cannot exist prior to the .OPENO request. 

The .OPENO request will return an error if the disk is 
full. 

c. Rules for .OPENI - .OPENI may be used for inputs from 
contiguous or linked files, or nondirectory devices. 

The file referenced in the corresponding Filename Block must 
exist in the directory. 

If a file is open for input (.OPENI), it cannot be opened for 
output, but it may be opened for extension or update. 

At any one time, a file can be opened for input to a maximum 
of 62., 0 or 76 0 datasets. 

-L KJ O 

d. Rules for .OPENU, OPENE, and .GPENC - The file must 
exist and cannot currently be opened for output. 

The file cannot currently be opened by another .OPENU, .OPENE, 
or . OPENC . 

A contiguous file can be opened for extension, provided that 
the area already allocated to the file does not need to be en- 
larged, which is not possible. 

A linked file cannot be opened with .OPENC, which is appli- 
cable only to contiguous files. 

Errors : If any of the preceding rules are violated, the Monitor 

places an error code in the STATUS byte of the Filename Block (see 
Table 3-7) and transfers control via the pointer in the ERROR RETURN 
ADDRESS of the Filename Block. If this address is 0, a fatal error 
message is printed on the teleprinter. Fatal error messages are 
listed in Appendix F. 

Example : (See .CLOSE) 
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.CLOSE 


3.6.4 . CLOSE - Close a dataset. 

Macro Call : .CLOSE # LNKBLK 

where LNKBLK is the address of the Link Block (see Figure 3-7) . 

Assembly Language Expansion : 

MOV # LNKBLK, - (SP ) 

EMT 17 

Global Name : CLS (See Appendix C for subsidiary routines.) 

Description : The .CLOSE request indicates to the Monitor that no 

more I/O requests will be made on the dataset. .CLOSE completes any 
outstanding processing on the dataset (e.g., on output, it writes the 
last buffer; on extension, it links the extension to the old file; 
etc.), updates any directories affected by the processing, and re- 
leases to free core any buffer space established for the processing. 
When a file which has been opened for output is closed, the last block 
written and the last byte written are recorded in the directory to 
indicate end-of-data. This eliminates the need to pad out blocks with 
nulls and allows the written data within a contiguous file to be 
extended at a later time. 

After the .CLOSE request has been completed, control is returned 
to the user at the instruction following the assembly language expan- 
sion; the argument is removed from the stack. As with .OPEN, some 
appropriate device action may still be in progress at this point (see 
Appendix C) . 

Rules : The dataset to be closed must have previously been 

opened if it was a file on a file-structured device. 

As with .OPENx, a .CLOSE is not required if the dataset is not 

a file* but it is strongly recommended in order to maintain device 
independence . 

Errors : Dataset Not Inited - Fatal Error F000; 

Device Parity Error - Fatal Error F017 
All error messages are explained in Appendix F. 


3-26 




t 

\ 


con t 


\ 

> 


Example : Open for input a dataset named IMP, which is file 

PR0G1.BIN on DECtape unit 3. After the data transfer is complete, 
close the file. 


.IN IT # SETl 

•OPEN #SET1, #FILE1 ; OPEN SETl FOR INPUT (OPEN CODE 
I ;IS IN FILE BLOCK) 

(Input is 
Performed 
Here) 

.CLOSE #SET1 ; CLOSE SETl 


.RLSE 

# SETl 


.WORD 

ERRl 


.WORD 

0 


. RAD 50 

/IMP/ 

; DATASET NAME 

.BYTE 

1,3 


.RAD 50 

/DT/ 

; PHYSICAL DEVICE NAME 


.WORD ERFl ; ADDR OF ERROR RTN 

.WORD 4 ; OPEN FOR INPUT 

FILEl : .RAD 50 /PRO/ ; FILENAME 

. RAD 50 /Gl/ 

.RAD 50 /BIN ; EXTENSION 

.BYTE PROG, PRO J 
.BYTE 177 
.EVEN 


ERRl : 


; HERE FOR . INIT, .OPENI, .CLOSE, 
; OR . RLSE ERRORS (DEVICE) 


ERFl: 


; HERE FOR .OPENI ERRORS 
; (DATA FILE) 
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.READ 


3.6.5 . READ - Read the next record in the dataset. 

Macro Cal l: .READ #LNKBLK, #BUFHDR 

where LNKBLK is the address of the Link Block, and BUFHDR is the ad- 
dress of the line buffer header. 

Assembly Language Expansion : 

MOV # BUFHDR, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 4 

Global Name : rwn (Routine is permanently core resident) . 

Description : The .READ request transfers the data from the device to 

the user's line buffer as specified in the line buffer header. The 
transfer is done via a buffer in the Monitor, into which an entire 
device block is read, and from which the desired data is transferred 
to the user's line buffer. Each read causes the user to receive the 
next record in the data set. Block boundaries are ignored and new 
blocks are read as needed. After any I/O transfer has been started, 
control is returned to the user at the next instruction, with the argu- 
ments removed from the stack. 

Refer to Section 3,9. 3.2 for more details on transfer modes. 

Rules : If the device is file structured, the .READ request 

must be preceded by an .OPENI. The user must provide in his pro- 
gram a line buffer and line buffer header (see Figure 3-9). Further 
actions on the dataset by the Monitor will be automatically postponed 
until the .READ processing has completed. The user program should, 
however, perform a .WAIT or . WAITR to ensure proper completion of trans- 
fer before attempting to use the data in the line buffer. Otherwise, 
he might find that he is processing before the data he wants has ar- 
rived. 

Errors : Specification of a transfer mode which is inappropriate 

for the device assigned to the dataset, attempting to .READ from or 
.WRITE to a file-structured device for which no file has been .OPENed 
or for which the type of .OPEN is incorrect will be treated as fatal 
errors and will result in a F010 message. 

Note : A dataset can only support transfers in one direction at 

one time, i.e., READ only or WRITE only. If the same device is to be 
used for both operations, spearate datasets must be used for each. 
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.WRITE 


3.6.6 . WRITE - Write the next record in the dataset. 

Macro Call : .WRITE #LNKBLK, #BUFHDR 

where LNKBLK is the address of the Link Block, and BUFHDR is the ad- 
dress of the line buffer header. 

Assembly Language Expansion : 

MOV # BUFHDR,- (SP) 

MOV # LNKBLK,- (SP) 

EMT 2 

G lobal Name : RWN (Routine is permanently core resident) . 

Description : The .WRITE request initiates the transfer of data from 

the user's line buffer to the device assigned. The data is first 
transferred to a buffer in the Monitor, where it is accumulated until 
a buffer of suitable length for the device is filled. 1 The data in the 
Monitor buffer is then transferred to the next device block, and any 
data remaining in the user's line buffer is moved to the (now emptied) 
Monitor buffer. After any I/O transfer to the device has been started, 
control is returned to the user at the next sequential instruction. 

The arguments are removed from the stack upon return. 

Refer to Section 3.9. 3. 2 for more details on transfer modes 
and the like. 

Rules : If the requested device is file structured, the dataset 

must have been opened by an .OPENO or .OPENE for a linked file, or 
.OPENC for a contiguous file. The user must provide a line buffer and 
its header in his program (Figure 3-9). 

Further actions on the dataset by the Monitor after .WRITE will 
be automatically postponed until the .WRITE processing has been com- 
pleted. Before refilling the line buffer, however, the user program 
should perform a .WAIT or . WAITR to ensure proper completion of the 
transfer. Otherwise, it might store new data on top of data which has 
not yet been written. 

Errors: See .READ for errors. 


*For terminal devices, data transfer also occurs when a line 
terminator is seen (see Section 3. 9.3.2). 
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.RECRD 

3.6.7 . RECRD - Read or write a specific record in a file. 

Macro Call ; .RECRD # LNKBLK, #RECBLK 

where LNKBLK is the address of the Link Block, and RECBLK is the 
address of the Record Block (see Figure 3-12) . 

Assembly Language Expansion : 

MOV # RECBLK, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 2 5 

Global Name : REC 

Description : The .RECRD request causes a specific record to be 

transferred to (or from) the user’s record buffer. Each record in 
the file may be individually addressed, and the user is not restricted 
to reading or writing the next record. Data transfer is by way of a 
buffer in the Monitor which will contain exactly one physical block 
of information. There is no rule concerning the relative sizes of 
records and blocks; however, efficiency may be improved if one is a 
multiple of the other. The Record Block specifies record number 
(starting at J0) , buffer address and length, and transfer direction 
(read or write). .RECRD requests require the use of the .INIT, . RLSE , 
.OPEN, .CLOSE, and .WAIT (or . WAITR) requests. After the transfer 
has started, control is returned to the user at the instruction 
following the assembly language expansion with arguments removed from 
the stack. 

Rules : The requested device must be file-structured and the 

file must be contiguous. 

The user must set up a Record Block in his program and must pro- 
vide a buffer. 

All records must have the same length. 

The user should perform a .WAIT or .WAITR to ensure that proces- 
sing has completed. 

The associated file must have been opened with .OPENU or .OPENI. 

Errors: An error causes a return to the user with the type 

of error indicated in the FUNCTION /STATUS word of the RECORD BLOCK. 

The user should perform the following test after his request to ensure 
that the request completed normally. 

TSTB RECBLK+1 
BNE ERROR 
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.BLOCK 


3.6.8 . BLOCK - Read or write a specific block in a file. 

Macro Call ; .BLOCK # LNKBLK, #BLKBLK 

where LNKBLK is the address of the Link Block, and BLKBLK is the ad- 
dress of the BLOCK block (see Figure 3-13) . 

Assembly Language Expansion : 

MOV # BLKBLK, - (SP ) 

MOV # LNKBLK,- (SP) 

EMT 11 


Global Name : BLO 

Description : BLOCK requests provide for random access to the 

blocks of files stored on disk or DECtape. 

In this mode, data is transmitted to or from a specified block 
in a file with no formatting performed. Transfers take place between 
the device block and a Monitor buffer. The user may process the 
data in the Monitor buffer or he may transfer the block to and from 
his own area. BLOCK requests require the use or the . INIT, .OPEN, 
•CLOSE and .WAIT (or .WAITR) requests. 

The user must specify one of three functions in the BLOCK block: 
INPUT, GET, or OUTPUT (see Figure 3-13). After the transfer has 
started, control is returned to the user at the instruction following 
the assembly language expansion with arguments removed from the stack. 


INPUT: 


GET: 


OUTPUT: 


During an INPUT request, the requested block of the 
requested file is read into a Monitor buffer, and the 
user is given in the BLOCK block (see Figure 3-11) 
the address of the buffer and the physical length of 
the block transferred. 

During a GET request, the Monitor returns in the BLOCK 
Block the address and length of a buffer within the 
Monitor that he can fill for subsequent output. Only 
one GET is required for each time the file is OPENed 
and CLO-SEd (i.e. , once a buffer has been located, it 
may be used repeatedly) . The user must assure that 
he does not over-run the buffer. This request is un- 
necessary if an INPUT request has occurred. 

During an OUTPUT request, the contents of the buffer 
assigned is written on the device in the requested 
relative position in the requested file. 


Rules : The associated file must be opened by .OPENI for input 

or . OPENU for input or output. 

M Access to linked files or nondirectory devices is illegal. 

The user must set up the BLOCK block in his program according to 
the format of Figure 3-13. 


3-31 



.BLOCK (cont) 


Errors : 
with the type 
BLOCK block. 

after a .WAIT 


Error processing causes a normal return to the user, 
of error indicated in the FUNCTION/STATUS word of the 
The user should perform 
TSTB BLKBLK+1 
BNE ERROR 

to assure that his request was error free. 
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,TRAN 


3.6.9 . TRAN - Read or write the specified block (file-structured 

device) or the next block (non-file-structured device) . 

Macro Call: .TRAN # LNKBLK, #TRNBLK 

where LNKBLK is the address of the Link Block, and TRNBLK is the ad- 
dress of the TRAN block (see Figure 3-14). 

Assembly Language Expansion : 

MOV #TRNBLK, - (SP) 

MOV # LNKBLK, - (SP) 

EMT 10 

Global Name : TRA 

Description : .TRAN provides nearly direct access to the device on 

which the dataset resides. No file processing is done and any file 
structure is ignored. Therefore, writing with .TRAN on a file- 
structured device is especially risky and many lead to the corruption 
of all data on the device. If .BLOCK request can be used instead of 
.TRAN, it is recommended. Each .TRAN will transfer one or more blocks, 
depending upon the word count in the TRAN Block. Blocks on file- 
structured devices are referenced by absolute block number, while blocks 
on non-file-structured devices are processed in sequence. .INIT, .RLSE 
and .WAIT (or . WAITR) must be used. .OPEN and .CLOSE must not. 

After the transfer has started, control is returned to the user at the 
instruction following the assembly language expansion. The arguments 
are removed from the stack. 

Rules : .TRAN must be preceded by an .INIT request on the as- 

sociated dataset. .OPEN must not be used. For each .TRAN request, 
the user must provide a transfer control block, as shown in Figure 
3-12. Further actions on the dataset by the Monitor will be automati- 
cally postponed until the .TRAN processing has been completed. The 
user program should perform a .WAIT or .WAITR to ensure proper com- 
pletion of the transfer before attempting to reference any location 
in the data buffer. 

Errors ; An invalid function code in the transfer control block 

will result in an error diagnostic message on the teleprinter at run 
time. 

Errors in the transfer will be shown in the FUNCTION/ STATUS word 
of the TRAN block; the last word of the block will be set to show 
how many data words have not been transferred. 
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TRAN (cont) 


Example : 
starting at 


TAPE1: 


BIN40: 


ERRl : 

BUFFER: 
BUFEND : 


Transfer 200 o words of data from DEC tape unit 3, 

O 

block 100g to core starting at location BUFFER. 


. INIT #TAPE1 


.TRAN #TAPE1 , #BIN40 


. RLSE #TAPE1 


.WORD ERRl 
.WORD 0 
. RAD50 /TP1/ 
.BYTE 1,3 
. RAD50 /DT/ 


.WORD 100 
.WORD BUFFER 
.WORD 200 
.WORD 4 
.WORD 0 


; ERROR ROUTINE FOR DECTAPE 


.WORD 0 
. BLKW 200 


.END 


; STARTING BLOCK # 

; STARTING ADDRESS IN CORE 
; NUMBER OF WORDS 
; INPUT 

; FOR MONITOR USE 
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.WAIT 


3.6.10 .WAIT - Wait for completion, of process on dataset. 

Macro Call : .WAIT #LNKBLK 

where LNKBLK is the address of the Link Block (see Figure 3-6). 

Assembly Language Expansion : 

MO V tt A-D-Liis r ~ vDi' ) 

EMT 1 

Global Name: (Routine is embedded in the resident Monitor.) 

Description : .WAIT tests for completion of the last requested action 

on the dataset represented by the referenced Link Block. If the action 
is complete (that is, if the request has completed all its action) , 
control is returned to the user at the next sequential instruction 
following the assembly language expansion; otherwise, the Monitor re- 
tains control until the action is complete. A .WAIT or .WAITR should 
be used to ensure the integrity of data transferred to or from a line 
buffer. The argument is removed from the stack. 

Rules : The dataset must be INITed. 

Errors : If the dataset is not INITed, a fatal error occurs and 

F000 is printed on the teleprinter. 
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.WAITR 


3.6.11 .WAITR - Check for completion of processing on dataset and 
return or transfer. 

Macro Call : .WAITR #LNKBLK, #ADDR 

where LNKBLK is the address of the Link Block, and ADDR is the address 
to which control is transferred if the processing is not complete. 

Assembly Language Expansion : 

MOV #ADDR, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 0 

Global Name : (Routine is imbedded in the resident Monitor.) 

Description : .WAITR tests for completion of the last requested 

action on the specified dataset. If all actions are complete, control 
is returned to the user at the next sequential instruction following 
the assembly language expansion. If all actions are not complete, 
control is given to the instruction at location ADDR. The arguments 
are removed from the stack. It is the user's responsibility to return 
to the .WAITR to check again. 

Rules : The user should use a .WAIT or a .WAITR request to 

assure the completion of data transfer to the user's line buffer be- 
fore processing the data in the buffer, or moving data into it. The 
dataset must be INITed. 

Errors : If the dataset is not INITed, a fatal error occurs 

and F000 is printed on the teleprinter. 
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.SPEC 


3.6.12 . SPEC - Special functions. 

Macro Call : .SPEC #LNKBLK, #SPCARG 

where LNKBLK is the address of the Link Block, and SPCARG may be 
either a special function code or the address of a special function 

block containing the code (see Figure 3-15) , depending upon the 
function. 

Assembly Language Expansion : 

MOV # SPCARG , - ( SP ) 

MOV # LNKBLK (SP) 

EMT 12 

Global Name : SPC 

Description : This request is used to specify a special function 

(action) to a device, such as rewind magnetic tape. A code identifies 
the function and must be in the range 0-255j_q- When the function 
requires no supporting data, the code itself is the first parameter 
to be placed upon the processor stack in the assembly language call 
sequence. However, if the user must supply additional information 
or if the function exoects to return data to the user, the code 
is passed within a special function block and the address of the 
block is the call parameter. The format of this block is shown in 
Figure 3-15. 

If a .SPEC request is made to a device which has no special 
function code, an immediate return is made showing that the function 
has been complete. After the request has been started, control is 
returned to the user at the instruction following the assembly lan- 
guage expansion. The stack is cleared. 

Rules : The dataset must be INITed. 

Errors: Fatal error F000 is returned if the dataset has not 

been INITed. 
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STAT 


3.6.13 . STAT - Obtain device status. 

Macro Call : .STAT #LNKBLK 

where LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV # LNKBLK,- (SP) 

EMT 13 

Global Name : STT 

Description : Determine for the user the characteristics of the 

device specified in the Link Block. After the request has been com- 
pleted, control is returned to the user at the instruction following 
the assembly language expansion. This request returns to the user 
with the following information at the top of the stack. 

SP Driver Facilities Word 

SP+2 Device Name (Packed Radix-50) 

SP+4 Device Standard Buffer 

Size (in words) 

where Driver Facilities Word has the following format; 


j 

1 










— 


— 

15 | 14 

13 | 12 

11 

10 

9 

8 

7 

6 

5 

4 

3 


1 



1 = device is directo 
structured 

1 = device is DECtape 

1 = device is sequential magnetic 

1 = system disk driver 

1 = device has multiple units 

one controller 
1 = device is a terminal 



= driver has an OPEN entry 



device will support multi - 
| dataset activity 
Ll = device will handle output 
— 1 = device will handle input 
— 1 = device will handle binary data 
— 1 = device will handle ASCII data 
— 1 = driver has a special function 
entry 

- 1 = driver has a CLOSE entry 


Device Name is the Radix-50 packed ASCII standard mnemonic for the 
device (Appendix A) ; and, Device Standard Buffer Size is the block 
size (in words) on a blocked device or an appropriate grouping size 
on a character device. 

Rules ; The dataset must be INITed. The user must clear the 

stack upon return. 
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.ALLOC 


3 . 7 REQUESTS FOR DIRECTORY MANAGEMENT SERVICES 

3.7.1 . ALLOC - Allocate (create a contiguous file). 

Macro Call ; .ALLOC #LNKBLK, #FILBLK, #N 

where LNKBLK is the address of the Link Block, FILBLK is the address 
of the Filename Block, and N is the number of 64-word segments re- 
quested . 

Assembly Language Expansion : 

MOV #N,-(SP) or MOV #N+lj000J0j2f , - (SP) 

MOV #FILBLK,- (SP) 

MOV # LNKBLK,- (SP) 

EMT 15 

Global Name : ALO (See Appendix C for subsidiary routines.) 

Description : Searches the device for a free area equal to N 64- 

word segments, and creates a contiguous file in the area if it is 
found, by making an appropriate entry in the User File Directory (UFD) . 
If the sign bit (bit 15) of N is set, the UFD pointer will point to 
the beginning of the allocated area thereby indicating that the file 
is empty. This enables partial filling of the file space and later 
extension of the file. If the sign bit of N is not set, the UFD 
pointer will point to the end of the allocated area and thereby indi- 
cate that the file area is full and may not later be extended. 

(Linked files are created by an .OPENO request. ) Search begins at 
the high end of the device. The number of blocks allocated will be 
the minimum number required to contain N segments, i.e., 

B1 

where B is the number of 64 -word segments per block. For example, if 

2 56 

N=9 and the device specified is DECtaoe, then B= — t-t = 4. Therefore, 

N 9 ‘ ‘ ' 64 

g- = j = 3, and 3 blocks will be allocated. 

After the request has been completed, control is returned to the 
user at the instruction following the assembly language expansion. 

The arguments are removed from the stack, and the top word of the 
stack will be set to -1 to indicate the successful completion of the 
request, or to the largest number of segments currently available if 
this is less than the called request. The value will be meaningless 
if the call cannot be met by reason of any other error. 
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ALLOC (cont) 


Rules : Must be preceded by an . INIT request on the dataset. 

A Filename Block must be set up by the user in his program. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the Filename Block if it is specified, or to the teleprinter for 
an error message if it is not. Possible errors are shown below: 


Error Condition 

Device Not Ready 
Dataset Not INITed 
File Exists 
Directory Full 


Error Code Returned 
To Filename Block 


2 

12 


Error Message 
On Default 

A002 

F000 

F024 

F024 

F024 

F024 

the top word of 


UIC Not In Directory 13 

Illegal Filename 15 


If the error address in the Filename Block is taken 
the stack is meaningless. 


Example : Create a contiguous file of four 2 56 1Q word blocks 

on DECtape unit 4. Name the file FREQ.DAT. 



.ALLOC 

#FRQ , #FREQIN , # 20 



INC 

@SP 



BNE 

NOROOM 



.WORD 

ERR1 


FRQ: 

.WORD 

0 



.RAD 50 

/DTA/ 



.BYTE 

1,4 



. RAD50 

/DT/ 



.WORD 

ERR2 



.WORD 

0 


FREQIN : 

. RAD50 

/FRE/ 



. RAD 50 

/Q/ 



. RAD50 

/DAT/ 



.WORD 

UIC , PROT1 


ERR1 : 

• 

; TO HERE IF 

NO BUFFER AVAILABLE 


• 

;FOR DRIVER 


ERR2 : 

. 

; TO HERE IF 

FILE STRUCTURED ERROR 

NOROOM: 

* 

; TO HERE IF 

NOT ENOUGH CONTIGUOUS 


; 

; BLOCKS ON DEVICE 
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.DELET 


3 . 1.2 .DELET - Delete a file. 

Macro Call : .DELET #LNKBLK, #FILBLK 

where LNKBLK is the address of the Link Block, and FILBLK is the ad- 
dress of the Filename Block. 

Assembly Language Expansion : 

MOV #FILBLK, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 21 

Global Name : DEL (See Appendix C for subsidiary routines.) 

Descr iption : Deletes from directory-oriented device the file named 

in the Filename Block. After the request has been completed, control 
is returned to the user at the instruction following the assembly 
language expansion. The arguments are removed from the stack. 

Rules ; .DELET operates on both contiguous and linked files. 

If the file has been OPENed, it must be CLOSEd before it is deleted. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the Filename Block if it is specified, or to the teleprinter for an 
error message if it is not. Possible errors are shown below: 


Error Code Returned Error Message 
Error Condition To Filename Block On Default 


Device Not Ready — A002 
Dataset Not INITed — F000 
Nonexistent File 2 F024 
Protect Code Violation 6 F024 
File Is Open 14 F024 


3-41 


.RENAM 


3.7.3 . RENAM - Rename a file. Change protection code. 

Macro Call : .RENAM # LNKBLK, #OLDNAM, #NEWNAM 

where LNKBLK is the address of the Link Block, OLDNAM is the address of 
the Filename Block representing the file, and NEWNAM is the address of 
the Filename Block containing the new information. 

Assembly Language Expansion : 

MOV #NEWNAM, - (SP) 

MOV # OLDNAM, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 20 

Global Name : REN (See Appendix C for subsidiary routines.) 

Description: Allows the user to change the name and protection code 

(see Section 3. 8. 6.3) of a file. After the request has been completed, 
control is returned to the user at the instruction following the assem- 
bly language expansion. The arguments are removed from the stack. 

Rules: Dataset must be INITed, and file must not be OPENed. 

The user must specify two Filename Blocks: one contains the name and 
protection code of the file as it presently is before the .RENAM re- 
quest, and the other contains the name and protection code of the file 
as it should be after the .RENAM request. The two filenames must be 
different. To change just the protection for a file, two .RENAMs must 
be requested. 

The new filename must not already exist, and the new filename 
must be legal. The old file must exist. 


NOTE 

Renaming a file assigned from the keyboard to the 
dataset will effectively be a NOP. 


Errors: Control is returned either to the ERROR RETURN ADDRESS 

in the offending Filename Block if it is specified and applicable, or 
to the Monitor for an error message if it is not. Possible errors 


are shown below: 

Error Condition 


Error Code Returned Error Message 

To Filename Block On Default 


Dataset Not INITed — F000 
File Exists (new name) 2 F024 
File Nonexistent (old file) 2 F024 
Protection Violation 6 F024 
File Is Open 14 F024 
Illegal Filename 15 F024 
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.APPND 


3.7.4 . APPND - Append one linked file to another. 

Macro Call : .APPND # LNKBLK, #FIRST, #SECOND 

where LNKBLK is the address of the Link Block/ FIRST is the address of 

the Filename Block for the first file (file to be appended to) , and 

SECOND is the address of the Filename Block for the second file (file 

to be appended) . 

Assembly' Language Expansion : 

MOV # SECOND , - ( SP ) 

MOV #FIRST/- (SP) 

MOV # LNKBLK,- (SP) 

EMT 22 

Global Name ; APP (See Appendix C for subsidiary routines.) 

Description : Makes one linked file out of two by appending the 

SECOND to the FIRST. The directory entry of the SECOND file is 
deleted. When the request is completed, control is returned to the 
user at the instruction following the assembly language expansion. 

The arguments are removed from the stack. No attempt is made to pack 
the two files together, the physical blocks are merely linked together. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the offending Filename Block if it is specified, or to the tele- 
printer for an error message if it is not. Possible errors are 
shown below: 


Error Code Returned 

Error Condition To Filename Block 


Error Message 
On Default 


Device Not Ready — A002 
Dataset Not INITed — F000 
First File Nonexistent 2 F024 
Contiguous File 5 F024 
Protect Code Violated 6 F024 
File Opened 14 F024 


NOTE 

Since the last block of a file is typically not 
full, there will be a gap (null characters) in 
the new file at the junction point. This causes 
no problem in ASCII files but might cause 
confusion in binary files. 
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LOOK 


3.7.5 . LOOK - Search the device directory for a specified filename. 

Macro Call : . LOOK #LNKBLK, #FILBLK [ , 1] 

where LNKBLK is the address of the Link Block, and FILBLK is the 
address of the Filename Block. 

Assembly Language Expansion : 

a. If the optional argument is not specified: 

MOV #FILBLK, - (SP) 

MOV # LNKBLK,- (SP) 

EMT 14 

b. If the optional argument is specified: 

MOV #FILBLK,- (SP) 

CLR - (SP) 

MOV # LNKBLK, - (SP ) 

EMT 14 

Global Name : DIR (See Appendix C for subsidiary routines.) 

Description : The primary purpose of this routine is to search 

through a specified directory for a specified file and return with the 
current parameters of the file. However, this routine can also be 
used to indicate (bits 0-3) the permissible functions for a nondirec- 
tory device (i.e., input, output, update, etc.). By specifying the 
optional argument, the user indicates whether he requires two or 
three parameters be returned. 

The device to be searched is specified in the Link Block, and the 
file is specified in the Filename Block. The request returns to the 
user with the top elements of the stack as follows 

2 Arg. Call 3 Arg. Call 
START BLOCK SP 

# OF BLOCKS SP SP+2 

INDICATOR WORD SP+2 SP+4 


where # OF BLOCKS is the number of blocks in the file, and the 
INDICATOR WORD is coded as follows: 


Bit 0=1 .OPENC allowed 

Bit 1=1 .OPENI allowed 

Bit 2=1 .OPENE allowed 

Bit 3=1 .OPENU allowed 

Bit 4=0 File is not in use 

4=1 File is being used by another dataset 

Bit 5=1 Dataset already has a file open 

(no search has been performed) 

Bit 6=0 File is linked 

6=1 File is contiguous 

Bit 7=0 File nonexistent (OPENO allowed) 

7=1 File exists or .OPENO not allowed 

Bits 8-15 Protection Code 
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.LOOK (cont) 

After the request has been completed, control is returned to the 
user at the instruction following the assembly expansion. The stack 
must be cleared by the user. If a file is protected against READ 
access, it will be signaled as nonexistent. 


Rules ; The dataset must be INITed. 

Errors : Control is returned either to the ERROR RETURN ADDRESS 

in the Filename Block if it is specified, or to the teleprinter for an 
error message if it is not. Possible errors are shown below: 

Error Code Returned 

Error Condition To Filename Block Error Message 


Device Not Ready 

— 

A002 

A File Is Open On 
Requesting Dataset 

14 

F024 

Illegal Filename 

15 

F024 


Note that it is possible to .LOOK for a file and be told that it 
does not exist. A subsequent attempt to open the nonexistent file 
may lead to an OPEN error (code=2) . Hence, it may be more efficient 
to simply attempt the .OPEN and check for an error (see Section 3.6.3). 
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KEEP 


3.7.6 .KEEP - Protect file from automatic deletion. 

Macro Call : .KEEP #LNKBLK, #FILBLK 

where FILBLK is the address of the Filename Block of the file to be 
protected and LNKBLK is the address of the Link Block. 

Assembly Language Expansion : 

MOV # FILBLK, - (SP ) 

MOV # LNKBLK,- (SP) 

EMT 24 

Global Name : PRO 

Description: Protects the named file from being deleted by the 

Monitor upon a Finish Keyboard command (see Chapter 2). It does this by 
setting bit 7 of the PROTECT byte in the Filename Block. Automatic 
deletion upon Finish is not currently implemented. 
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Macro Call : .RUN #RUNBLK 

where RUNBLK is the address of the user's Run Block (see Figure 3-16). 
Assembly Language Expansion : 

MOV # RUNBLK.- (SP) :PUSH ADDRESS OF THE RUN BLOCK 

EMT 65 ; ONTO THE STACK 

Global Name : RUN 

Description : The RUN request may be used to load an entire program 

or a program overlay. It has several options, among which are: 

load a program or load an overlay - when an overlay is 
loaded, the existing program environment is not disturbed; 
one section of the program is simply replaced by another. 
When a new program is loaded, the old program and its 
effects (except for data on the stack) are purged from 
core, and the new program takes over; for example, FORTRAN 
can use the RUN request to load LINK and LINK can use it 
to load and execute the user's program; 

load a core image or a load module; 

return of control: 

instruction following .RUN; 

transfer address of load module or core image; 
transfer address plus offset (word F) ; 
alternate return address (word G) ; 
stack movement: 

leave as is; 

move the stack down if it vrould otherwise be destroyed 
by the entity being loaded; 

load address: 

as specified in file, 

as specified by user. 

The RUN request requires the following control blocks: 

Run Block: A variable length control block whose address is 

passed on the stack. It contains a function word 
and various optional parameters. It is described 
in Section 3.9.8. 

Link Block: The standard Link Block (section 3.9.1). It de- 

scribes the device from which the entity is to be 
loaded. It is required unless bit 15 of the function 
word in the Run Block is 1. 
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.RUN (cont) 

File Block: The standard File Block (section 3.9.2). It de- 
scribes the file from which the entity is to be 
loaded: either an . LDA file or a CIL. It is 

required unless bit 15 of the function word 
in the Run Block is 1. 

The Link Block should not be .INITed, nor should the File Block be 
.OPENed, when .RUN is called. RUN will perform .OPEN, .CLOSE, . INIT 
and . RLSE processing. The lookup sequence is as follows: 

First an extension of LDA is attempted, then no extension, 
unless an extension is specified, in which case it alone 
is used; 

For each extension, the current UIC, then [1,1] is tried, 
unless a UIC is specified, in which case it alone is used; 

The .RUN request always removes the Run Block address from the stack. 
If bit 0 is 0, the following information will be returned upon the 
stack: 


(SP) - transfer address of loaded module, 

2(SP) - size of loaded module in bytes, 

4 (SP) - low address of loaded module. 

Aside from this, the stack is not disturbed, although it may be moved. 
This means that the stack may be used for passing arguments. 

Rules : The Link Block should not be .INITed. 

The File Block should not be .OPENed. 

If an overlay is being loaded, it must not extend 
above the bottom of the resident program section, 
nor below the top of the Monitor . 

If a new program is to be loaded, all datasets used 
by the current program must be RLSEd. 

The user must be sure that his stack is not inadvert- 
ently destroyed. 

When options are requested through the function word, 
the appropriate supporting data must be present in 
the Run Block. 

If the stack might be moved, it must not contain 
absolute pointers to locations within the stack. 

For example: 

MOV SP , R0 
MOV R0 , - ( SP ) 

produces a stack which should not be moved. The 
user can assure that such a stack will not be moved 
by setting bit 1 of the Function word in the RUN 
Block to 0 (see Section 3.9.8). 

Errors : Errors F007, F012, F021, F022, F024, F045, F054, F274, F276, 

and F277 are all possible. All but F007 and F021 are nonfatal, pro- 
vided that an error return is provided in the File Block (see Table 3-4). 
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.EXIT 


3.8.2 Request to Return Control to the Monitor 

3.8. 2.1 . EXIT - Exit from a user program to Monitor. 

Macro Call : .EXIT 

Assembly Language Expansion: 

EMT 60 

Global Name : XIT 

Description : This is the last statement executed in a user's pro- 

gram. It returns control to the Monitor, assures that all of the pro- 
gram's data files have been closed and, in general, prepares for the 
next keyboard request. After the exit, all Monitor buffer space re- 
served for the program, such as Device Assignment Tables (DAT) estab- 
lished during program execution, are returned to free core. 
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.TRAP 


3.8.3 Requests to Set Monitor Parameters 

In addition to the above programmed requests, the user can provide 
the Monitor with data to be stored in Monitor Tables or can request 
information on the content of those tables via the EMT level 41 in- 
struction. The user communicates his request to the Monitor by pushing 
the necessary parameters and an identifier code onto the stack. If the 
code is outside the ranges of those currently established, a fatal 
error (F002) will result. 

3. 8. 3.1 . TRAP - Set interrupt vector for the trap instruction. 

Macro Call : .TRAP # STATUS , #ADDR 

where STATUS is the desired status for the trap, and ADDR is the 
address for the trap. 

Assembly Language Expansion : 

MOV #ADDR, — (SP) 

MOV # STATUS,- (SP) 

MOV #1,-(SP) ; 1 is the identifier code for .TRAP 

EMT 41 

Global Name : GUT 

Description : Sets the STATUS and ADDR into trap vector 34. After 

the request is completed, control is returned to the user at the in- 
struction following the assembly language expansion. The stack is 
cleared. The user may then use the trap instruction. 

Rules : STATUS must be a valid Status Byte. 

ADDR must specify an address within the user's core area. 

Errors : If an invalid code is specified, a fatal (F002) error 
will result. 
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.RSTRT 


3. 8.3. 2 . RSTRT - Set the default address for use by the REstart 

keyboard command. 

Macro Call : .RSTRT #ADDR 

where ADDR is the restart address. 

Assembly Language Expansion : 

MOV #ADDR, - (SP) 

MOV #2,-(SP) ; 2 is the identifier code for .RSTRT 

EMT 41 

Global Name : GUT 

Description : Sets the address where the program should restart in 

response to the keyboard command REstart. This is the assumed address 
in the absence of an address in the REstart command. It can be reset 
as often as requested by the program. After the request is completed, 
control is returned to the user at the instruction following the 
assembly language expansion. The stack is cleared. 

Rules: ADDR must be an address within the user's core area. 
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CORE 


3.8.4 Requests to Obtain Monitor Parameters 

3. 8. 4.1 . CORE - Obtain address of the highest word in core memory. 

Macro Call : .CORE 

Assembly Language Expansion : 

MOV #100,- (SP) ; CODE 

EMT 41 

Global Name ; GUT 

Description ; Determines the address of the highest word in core 
memory (core size minus 2) and returns it on the top of the stack. 

For an 8K machine, it would return 37776. The user must clear the 
stack. 

Errors : No errors are possible. 
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.MONR 


3. 8. 4. 2 .MONR - Obtain the address of the first word not within 
the resident Monitor. 

Macro Call : .MONR 

Assembly Language Expansion : 

MOV 4 i n i .— ( p.p \ 

EMT 41 

Global Name : GUT 

Description : Determines the first word above the top of the cur- 

rently resident Monitor (see Figure 3-5) and returns it to the user 
at the top of the stack. This value does not reflect any area 
allocated by the Monitor for control blocks, device drivers, data 
buffers, etc. (see .MONF, Section 3. 8. 4. 3). After the request is 
completed, control is returned to the user at the instruction follow- 
ing the assembly language expansion. The user must clear the stack. 

Errors : _ No errors are possible. 
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.MONF 


3. 8. 4. 3 .MONF - Obtain the address of the first word above the 
Monitor's highest allocated free core buffer. 

Macro Call : .MONF 

Assembly Language Expansion : 

MOV #102, -(SP) 

EMT 41 

Global Name : GUT 

Description : The address of the first word above total Monitor area 

(see Figure 3-5) , including the buffer and transient areas current at 
the time of the request, is returned to the user at the top of the stack. 
After the request is completed, control is returned to the user at the 
instruction following the assembly language expansion. The user must 
clear the stack. 


Rules : Since buffers are allocated by the Monitor in its 

processing of certain requests, .MONF should be placed in the program 
at the point where the information is actually required. 


xx7776 0 
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Device Assignment Table 
Generated After Load Time 

Monitor Buffers 
(Data Buffers, Data Control 
Blocks, Drivers, etc.) 
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Generated Before Start of Program 


Monitor Routines Resident 
For Program Duration 


Device Assignment Table 
Generated Before Load Time 

Permanently Resident Monitor 
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Programs 
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Figure 3-5 Core Map of Resident Monitor and Full Monitor. 
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■ DATE 


3.8.4. 4 . DATE - Obtain current date. 

Macro Call : .DATE 

Assembly Language Expansion : 

MOV #103, -(SP) 

EMT 4 1 

Global Name : GUT 

Description : The current date word is returned to the user at the 

top of the stack. The user must clear the stack. The date format is 
a binary number equal to Julian-70 , OOO^q . If the user requires the 
ASCII representation of the date, he should use the .CVTDT request 
(see 3. 8. 4. 6) . 

Errors : No errors are possible. 
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.TIME 


3. 8.4. 5 . TIME - Obtain current time of day. 

Macro Call : .TIME 

Assembly Language Expansion : 

MOV # 104 , - (SP ) 

EMT 41 

Global Name : GUT 

Description : The two current time words are returned to the user 

at the top of the stack. 


SP: 

LOW-ORDER TIME IN TICKS 

SP+2 : 

HIGH- ORDER TIME 


where a TICK is 1/60 of a second (1/50 second for 50-cycle lines). 

The words are 15-bit unsigned numbers. The user must clear the 
stack. See the CVTDT request for how to obtain the ASCII repre- 
sentation of current time value. 

Errors : No errors are possible. 
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.CVTDT 

3 * 8 *4.6 . CVTDT - Convert binary representation of date or time to 

ASCII character string. 

Macro Call : .CVTDT #CODE, #ADDR[ , VALUE] 

where CODE identifies the conversion to be done; 

CODE = J 2 Current date as stored by monitor, 

CODE = 1 Current time as stored bv monitor . 

CODE = 2 Date supplied as VALUE, 

CODE = 3 Time supplied as VALUE (and VALUE+2) 

ADDR is the address of the first byte of the user buffer into which 
the ASCII string is to be stored, and VALUE is the address of user 
supplied Date or Time (used with CODEs 2 and 3 only) . 

Assembly Language Expansion : 

MOV VALUE+2, - (SP) ? Code 3 only 
MOV VALUE, -(SP); Codes 2 and 3 only 

MOV #ADDR, - (SP ) 

MOV #CODE , - (SP ) 

EMT 6 6 

Global Name ; CDT 

Description ; This request converts either a date or a time from 
internal (binary) representation into an ASCII string suitable 
for display. The user may specify that the current system value 
(of date or time) is to be used for conversion or he may supply 
his own value. The string returned has the format of the Date and 
Time returned by the Keyboard DATE and TIME commands (see Chapter 2). 
Upon return, the call arguments have been removed from the stack and 
condition codes N, Z and V are cleared to 0 . 


Rules: 1. 


2 . 


The buffer area supplied by the user program (starting 
at ADDR) must provide sufficient room for the text 
returned as no check is made. Nine bytes are required 
for Date, eight bytes are required for Time. 
User-supplied VALUES for Date or Time must comply 
with the internal storage format of those values, that 
is: 

a. Date; 1 word containing (year-1 97J0 ) *1000 + day 

of the year (Julian) . 

b. Time; 2 unsigned integer words for high-order 

and low-order time in clock ticks. 
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. CVTDT (cont) 


Errors ; 1. Specification of an illegal CODE (i.e., > 3) causes 

fatal error message: 

FJ034 Call address 

2. If the currently stored Date or Time is out of range 
(i.e., Date > 366 (Modulo 1000 ) or Time > 47:59:59), an 
operator action message 

A011 CODE (0 = Date, 1 = Time) 
is printed. The operator should enter the desired 
value via the appropriate DAte or Time keyboard 
command and type continue to proceed. If 23:59:59 
< Time < 48:00:00, Date is incremented and Time is 

reduced by 24:00:00. 

3. If a user supplied Date or Time is out of range as 
above, the conversion routine will return without 
attempting conversion and the condition code V will 
be set to 1. Thus the program should follow the 
.CVTDT request with the check: 

BVS (error routine) . 
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GTUIC 


3. 8.4.7 . GTUIC - Get the current user's UIC. 

Macro Call : .GTUIC 

Assembly Language Expansion : 

MOV #105, -(SP) ; CODE 

EMT 41 

Global Name : GUT 

Description : The current user ' s UIC is returned at the 

top of the stack. The user must clear the stack. 

Errors : No errors are possible. 
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SYSDV 


3 . 8. 4. 8 . SYSDV - Get name of the system device. 

Macro Call : . SYSDV 

Assembly Language Expansion ; 

MOV #106,- (SP) 

EMT 41 

Global Name : GUT 

Description: The name of the system device in Radix-50 notation is 

returned to the user at the top of the stack. 

Errors: No errors are possible. 
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GTPLA 


3.8.4.S . GTPLA - Return the current program low address. 

Macro Call ; .GTPLA 

Assembly Language Expansion ; 

CLR - (SP) 

MOV # 5 / - ( SP ) 

EMT 41 

Global Name : GUT 

Description : The program low address is the address of the first 

(lowest) word of the current program. In the case of a program with 
overlays, the PLA is the address of the first word of the resident 
section. PLA is established when the keyboard RUN command is executed 
or when the .RUN request is used to load a new program (not an over- 
lay, e.g., when MACRO calls CREF, which then replaces MACRO). Because 
the .RUN processor will not load an overlay which extends above this 
address, the PLA is also called the Protection Boundary. 

.GTPLA allows the user to retrieve this value (see Figure 3-5) , 
which is returned to the top of the stack. . STPLA allows the user to 
set it. 

Rules : The user must clear the stack. 

Errors : No errors are possible. 
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.STPLA 


3.8.4.10 . STPLA - Set the program low address. 

Macro Call : .STPLA #ADDR 

where ADDR is the desired new program low address. 

Assembly Language Expansion : 

MOV #ADDR, - (SP) 

MOV # 5 , - (SP ) 

EMT 41 

Global Name : GUT 

Description : This request allows the user to establish a new pro- 

gram low address. This is done if the user wants part of his resident 
code overlayed or if he wants to reserve additional space between his 
resident code and his overlays. Consult the .GTPLA description for 
more details. 

The old program low address (or a zero) will be returned on top 
of the stack upon return from this macro call. 

Rules: The user is required to clear the returned address 

from the stack. 

Errors: The address returned on top of the stack will be zero 

when the call is unsuccessful. This occurs when the address is out- 
side of available memory. 
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.GTCIL 


3,8.4.11 . GTC IL - Return the address of the first block of the 

Monitor core image library (CIL) . 

Macro Call : .GTCIL 

Assembly Language Expansion : 

MOV #111,- (SP) 

EMT 41 

Global Name : GUT 

Description : This request returns the address of the first block 

of the Monitor core image library to the top of the stack. 

Rules : The user is required to clear the disk address returned 

on tiio stsck* 

Errors ; No errors are possible. 
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.GTSTK 


3.8.4.12 .GTSTK - Return the current stack base entry. 
Macro Call: .GTSTK 


Assembly Language Expansion: 


CLR -(SP) 
MOV # 4 , - (SP) 
EMT 41 


Global Name : GUT 

Description : The stack base is the highest core address used for 

stack storage plus two. A RUN Keyboard command clears the stack and sets 
the stack base address to the program low address. A user .RUN request 
does not clear the stack (to allow inter-program communication via the 
stack) but the stack may be relocated. This request may be used to 
determine the stack base. Following the request the current stack 
base entry is returned on top of the stack. 

Rules: The user is required to clear the returned value from 

the stack. 

Errors : No errors are possible. 
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.STSTK 


3.8.4.13 . STSTK - Modify the stack base entry. 

Macro Call : .STSTK #ADDR 

where ADDR is the desired new stack base address entry. 

Assembly Language Expansion : 

MOV #ADDR, - (SP ) 

MOV # 4 , - (SP) 

EMT 41 

Global Name : GUT 

Description : This request is used when the stack is to be relocated. 

It does not relocate the stack, but it does record its new base (the 
address of the word immediately above the stack; see section 3.8.4.12), 
and it returns the old stack base on the stack. EXTREME CAUTION should 
be used when moving the stack; it is not recommended as a standard 
procedure. Note that the .RUN request may be used to move the stack 
when that is appropriate. 

Rules : The user must clear the old base value from the stack 

when control is returned. 

The user is responsible for moving the stack. 

Caution should be used when moving the stack, since the new and 

old stack areas may overlap and since Monitor interrupt routines may 

use the stack while it is being moved. Let: 

SBl = old stack base (returned on stack) 

SB2 = new stack base (supplied by user) 

SP1 = old stack pointer (current value of SP) 

SP2 = new stack pointer (SB2 - SBl + SP1) 

First, set SP=min (SP1,SP2) to protect against interrupts. Then if 

SBKSB2, move the stack starting from the base (SBl to SB2) , If 

SBl >SB2 , move the stack starting from the top (SP1 to SP2) . This 

strategy prevents the stack from being corrupted during the move 

(since the two stack areas might overlap). Finally, set SP to SP2. 

Errors : If the new stack base ADDR is outside available memory 

or inside the Monitor, the request is not honored and a zero is re- 
turned on the stack. 
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.STFPU 


- STFPU 


3.8.4.14 . STFPU - Initialize the floating-point exception vector. 

Macro Call: .STFPU #PSW,#ADDR 


Assembly Language Expansion : 

MOV #ADDR,-(SP) 
MOV #PSW,- (SP) 

MOV #3 , - (SP) 

EMT 41 


ADDRESS OF EXCEPTION ROUTINE 
PROGRAM STATUS WORD FOR 
EXCEPTION RTN 
REQUEST CODE 


Global Name : GUT 

Description : This request initializes the exception interrupt 

vector for the floating-point processor on the PDP-11/40 or PDP-11/45. 
Any floating-point exception for which interrupt is enabled will cause 
a trap to location ADDR with a new program status word of PSW. The 
interrupt vector is at location 244g. 


Rules: None . 


Errors : 


None. 



.RADPK 


3.8.5 Requests to Perform Conversions 

Using the EMT level 42 instruction the user can request data 
conversions between binary and some external form such as decimal 
ASCII or Radix-50. He communicates his request by pushing the nec- 
essary parameters and an identifier code onto the stack. If a code 
outside the range of those currently established is specified, a 
fatal error (F034) will result. 


3. 8. 5.1 .RADPK - Pack three ASCII characters into one Radix-50 word. 
Macro Call : .RADPK #ADDR 

where ADDR is the address of the first byte in the 3-byte string of 
AS^II characters to be converted. 


Assembly Language Expansion : 

MOV #ADDR,-(SP) 
CLR - (SP) 

EMT 42 


;MOVE CALL CODE ONTO STACK 


Global Name: 


CVT 


Description : The string of 7- or 8-bit ASCII characters in three 

consecutive bytes starting at ADDR is converted to Radix-50 packed 
ASCII using the algorithm shown below. The packed value is returned 
on the top of the stack, followed by the address of the byte follow- 
ing the last character converted. The user must clear the stack. 

Radix-50 is used by the Monitor to store in one word three 
characters for half a filename or an extension or other three- 
character sets of data. 

Because the characters allowed within names (e.g., filenames 
or extensions, assembler symbols, etc.) are restricted to letters, 
digits, and a few special characters, it is possible to store three 


( (C 1 x 50g ) + C 2 ) x 50g + C 3 


where C^ Cg, and Cg are the three characters converted from their 
original ASCII value to the value shown in the following table. 


3-67 



. RADPK (cont) 


Space 

A-Z 

$ 

unused 

0-9 


ASCII Value 

Radix-50 Value 

40 

0 

101-132 

1-32 

44 

33 

56 

34 


35 

60-71 

36-47 


The maximum value for three characters is thus: 

47 x 50 2 + 47 x 50 + 47 = 174777 


The Radix-50 representation for various peripheral devices is 
shown below: 


Mnemonic 


Device 


Radix-50 

Equivalence 


CR Card Reader (CR11) 

DC RC11 Disk 

DF RFll Disk 

DK (A, B) RK11 Disk 

DT (A) DECtape (TC11) 

KB ASR-33 Keyboard/Printer 

LP Line Printer (LP11) 

MT Magtape (TM11) 

PP High-Speed Paper Tape Punch 

PR High-Speed Paper Tape Reader 

PT ASR-33 Paper Tape Device 


012620 

014570 

014760 

015270 (+1,2) 

016040 (+1) 

042420 

046600 

052140 

063200 

063320 

063440 


NOTES: a. Device mnemonics may be three letters on some systems. 

The third letter is assigned if there is more than one 
controller. For example: 

DTA for DECtape controller A 

DTB for DECtape controller B 

b. The device name may be followed by an octal number to 
identify a particular unit when the controller has 
several device units associated with it. For example: 

DTI for unit 1 under a single DECtape control 

DTA1 for unit 1 under controller A in a multi- 
controller situation. 

Errors : The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error 
via the condition codes in the Processor Status register: 

C-bit set means that an ASCII byte outside the valid 

Radix-50 set was encountered. 

The value returned will be left-justif ied and correct up to the last 
valid byte, e.g. , DT: = DT : . The address returned will be that of 
the first invalid byte. 
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. RADPK (continued) 


If no errors were encountered during the conversion, the con- 
dition codes will be cleared. 


Example : Pack a string of 3 0 -^q ASCII characters, starting at 

UNPBUF, into a buffer starting at 



MOV 

# PAKBUF, R3 


MOV 

#UNPBUF , — ( SP ) 

NEXT: 

CLR 

- (SP) 


EMT 

42 


BCS 

ERRC 


MOV 

(SP)+, (R3)+ 


CMP 

R3,#PAKBUF+12 


BNE 

NEXT 


TST 

(SP) + 


PAKBUF . 


; SET UP POINTER TO PACK BUFFER 
? .RADPK UNBUF 


; INVALID ASCII CODE ENCOUNTERED 
;MOV PACKED VALUE TO BUFFER 
; END OF STRING? 

; NO 

; YES - REMOVE POINTER FROM STACK 


Note that this example takes advantage of the fact that the Monitor 
returns on the stack the address of the byte which follows the last 
character converted. 
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.RADUP 


3. 8.5.2 . RADUP - Unpack one Radix-50 word into three ASCII characters. 

Macro Call : .RADUP #ADDR, WORD 

where ADDR is the address of the first of three bytes into which the 
unpacked characters are to be placed, and WORD is the Radix-50 word 
to be converted. 

Assembly Language Expansion : 

MOV WORD , - (SP) 

MOV # ADDR , - ( SP ) 

MOV #1,-(SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name : CVT 

Description : WORD is converted into a string of 7-bit ASCII char- 

actors which are placed left- justified with trailing spaces in three 
consecutive bytes starting at location ADDR. The stack is cleared. 

See section 3. 8. 5.1 for a definition of Radix-50. 


Errors : If an error is encountered, the user will be informed 

via the condition codes in the Processor Status register. 

C-bit set means: a. a value of WORD was outside the valid 

Radix-50 set, i.e., >174777 (see 
Section 3 . 8. 5. 1) . 

b. a Radix-50 byte value was found to be 
35, which is currently not used. 

Nevertheless, three bytes will be returned with a : as the first of 
the three for error type (a) , and a / for any of the three bytes for 
error type (b) . 

If the conversion is satisfactory, the condition codes are 
cleared . 
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.D2BIN 


3. 8. 5.3 . D2BIN - Convert five decimal ASCII characters into one 

binary word. 


Macro Call : .D2BIN #ADDR 

where ADDR is the address of the first byte in the 5-byte string of 


Assembly Language Expansion : 

MOV #ADDR, - (SP) 

MOV #2, - (SP) ; MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name: CVT 


Description : 


The 5-byte string of 7- or 8-bit decimal ASCII 


phpranf ore i o -f-a r f o 4- ZSFM^'D cs c 


:he: 


iDlIxdj 


ecru iv 


alent. The converted value is returned to the top of the stack, 
right- justified, followed by the address of the byte which follows 
the last character converted. The largest decimal number that can be 
converted is 65,535 (2‘*" 6 -l) . The user must clear the stack. 


Errors : The conversion will be stopped if an error condition 

is encountered. The user will be informed of the type of error via 

the condition codes in the Processor Status register. 

C-bit set means that a byte was not a decimal digit. 

V-bit set means that the decimal number was too large, 
i.e., greater than 65535. 

The value returned will be correct up to the last valid byte. The 
address returned will be that of the invalid byte. If the conversion 
is satisfactory, the condition codes will be cleared. 
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BIN2D 


3. 8. 5. 4 . BIN 2D - Convert one binary word into five decimal ASCII 

characters. 

Macro Call : . BIN2D #ADDR, WORD 

where ADDR is the address of the first byte of the buffer where the 
characters are to be placed, and WORD is the number to be converted. 

Assembly Language Expansion : 

MOV WORD , - ( SP ) 

MOV #ADDR, - (SP) 

MOV #3 , - (SP) ;MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name : CVT 

Description : WORD is converted into a string of five decimal 

7-bit ASCII characters which are placed into consecutive bytes start- 
ing at location ADDR. They are right- justified with leading zeros. 
The stack is cleared. 

Errors : No errors are possible. 
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02BIN 


3. 8. 5. 5 . 02BIN = Convert six octal ASCII characters into one 

binary word. 

Macro Call : .02BIN #ADDR 

where ADDR is the address of the first byte in the 6-byte string of 
octal characters to be conv e rted . 

Assembly Language Expansion : 

MOV #ADDR, - (SP ) 

MOV #4 , - (SP) } MOVE CALL CODE ONTO STACK 

EMT 42 

Global Name ; CVT 

Description : The 6-byte string of 7- or 8-bit octal ASCII char- 

acters which starts at ADDR is converted into the binary number 
equivalent. The converted value is returned to the top of the stack, 
right- justified, followed by the address of the byte which follows 
the last character converted. The largest octal number which can be 
converted is 177777. The stack must be cleared by the user. 

Errors: The conversion will be stopped if an error condition 

is encountered, and the user will be informed of the type of error 

via the condition codes in the Processor Status register: 

C-bit set means that a byte was not an octal digit. 

V-bit set means that the octal number was too large, 
i.e., the first byte was greater than 1. 

If the conversion has been satisfactory, the condition codes are 

cleared. Following C- or V-bit errors, the value returned will be 

correct up to the last valid byte. The address returned will be that 

of the first invalid byte. 
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BIN20 


3. 8. 5. 6 . BIN20 - Convert one binary word into six octal ASCII 

characters . 

Macro Call : .BIN20 # ADDR, WORD 

where ADDR is the address of the first byte of the buffer into which 
the six octal ASCII characters are to be placed, and WORD is the 
binary number to be converted. 

Assembly Language Expansion : 

MOV WORD , - (SP) 

MOV #ADDR,-(SP) 

MOV # 5 , - (SP) 

EMT 42 

Global Name : CVT 

Description : The WORD is converted into a 6-byte string of 7-bit 

octal ASCII characters, right- justified with leading zeros, which is 
placed into the buffer addressed by ADDR. The stack is cleared. 

Errors : No errors are possible. 
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3.8.6 Requests for Interfacing with the Command String Interpreter 

A user program may obtain dataset specifications via keyboard 
input at run time by calling the Command String Interpreter (CSI) 
routine. This routine is used by many system programs; it accepts 
keyboard input at program run time in the format presented in 
Appendix H. 

The CSI is called in two parts, by two different requests: 

.CSI1 condenses the command string and checks for 
syntactical errors. 

.CSI2 sets the appropriate Link Block and Filename 

Block parameters for each dataset specification 
in the command string. 

Each command string requires one .CSI1 request for the entire command 
string, and one CSI2 request for each dataset specifier in the 
command string. 

The user must first set up a line buffer in his program and 
read in the command string. Then he does a .CSI1, which condenses 
the string by eliminating spaces, horizontal TABs, nulls, and RUBOUTs, 
sets pointers in a table to be referenced by .CSI2, and checks the 
command string for syntactical errors. If there are no errors, the 
.CSI2 request may be given once for each dataset specification that 
the user expects to find in the command string. .CSI2 fills in the 
appropriate Link Block and Filename Block parameters according to the 
device name, filename, extension, UIC, and switch entries in the 
command string. 
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-CSI1 


3. 8, 6.1 . CSI1 - Condense command string and check syntax. 

Macro Call : .CSI1 #CMDBUF 

where CMDBUF is the address of the command buffer header described 
under "Rules" below. 

Assembly Language Expansion : 

MOV #CMDBUF,- (SP) 

EMT 56 

Global Name : CSX 

Description ; Condenses the command string by removing spaces, 
horizontal TABs, nulls, and RUBOUTs, and checks the entire command 
string for syntactical errors. Control is returned to the user with 
a 0 at the top of the stack if the syntax is acceptable, or with the 
address (in the command string line buffer) of the data byte at which 
the scan terminated because the first error was encountered. 

Rules : The .CSI2 request must be preceded by a .CSI1 request, 

because . CSI2 assumes it will get a syntactically correct command; 
more than one .CSI2 request can follow a single .CSI1 request. 

The user must set up a line buffer and read in the command string 
before doing .CSI1. Command Strings must not be read in dump mode. 

It is the user's responsibility to print a # on the teleprinter 
to inform the operator that a CSI format is expected (Section 2.1). 

If VERTICAL TAB is used as the terminator, the # will be typed 
immediately without a carriage return or line feed. 

The user must set up a seven-word command buffer header in his 
program immediately preceding the header of the line buffer into whicn 
the command is to be read. The user is not required at this time to 
set up anything in the command buffer header prior to calling .CSI1; 
it will be used as a work-and-communication area by the Monitor 
routines which process the .CSIl and .CSI2 requests. 

The user must clear the stack upon return from the Monitor. If 
the top of the stack ^ 0 (i.e., if there was a syntax error), .CSI2 
must not be called. 

Example : See .CSI2, Section 3. 8. 6. 2. 
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CSK2 


3, 8. 6. 2 . CSI2 - Interpret one dataset specification of a command 

string. 

Macro Call : .CSI2 #CSIBLK 

where CSIBLK is the CSI control block, described under "Rules” below. 

Assembly Language Expansion : 

MOV #CSIBLK, - (SP) 

EMT 57 


Global Name: CSM 


Description : Gets the next input or output dataset specification 

from the command string, and sets the PHYSICAL DEVICE NAME entry in 


-i- 'U ^ T 4 I. Dl BTT OWRM1? PVmmTCTAVf >•> ^3 TT ■ 

Ufi€? JJXHK Di O^-Tv / Uilt? JC f JjAIDIMPXU^ f CllK* w. 


name Block, and any switch entries in an extension of the Link Block. 


Rules : Before calling .CSI2, the user must: 

• Call .CSI1 to condense the command string and check it for 
syntax errors. There must have been no syntax errors. 




Set up a CSI control block as follows: 


CSIBLK: 


POINTER TO CMDBUF 
POINTER TO LNKBLK 
POINTER TO FILBLK 


where POINTER TO CMDBUF is the address of the 7 -word work 
area preceding the command string line buffer header; 

POINTER TO LNKBLK is the address of the Link Block of the 
dataset whose specification is being requested; and 

POINTER TO FILBLK is the address of the Filename Block of 
the dataset whose specification is being requested 
(currently, CSI allows only one file per dataset specifi- 
cation) , 

• Set the first word (Code Word) of CMDBUF to either 0 or 2. 

0 means "get next input dataset specification" , and 2 means 
"get the next output dataset specification". .CSI2 does not 
check the validity of the code word. 

• Initialize the NUMBER OF WORDS TO FOLLOW entry in the Link 
Block to contain the number of words to follow. This must 
be at least one, because . CSI2 will alter the following 
word, i.e., the PHYSICAL DEVICE NAME word. .CSI2 does not 
check the validity of this byte. 

The user may specify any number from 1 to 255^0 i n this 
location. All words in excess of 1 are used for switch 
space (see the interface with respect to switches, de- 
scribed below) . 
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.CSI2 (cont) 

Upon return from the .CSI2 request, the Monitor will have provided the 
following information: 

• The top of the stack contains two items of information. 

Bits 1-0 have the following meaning: 

a. 0, which means the dataset specification requested has 

been obtained, and there are still more dataset 
specifications of the type requested (i.e., input 
or output); or 

b. 1, which means the dataset specification requested has 

been obtained, and there are no further dataset 
specifications of the type requested; or 

c. 2, which means (a) , but this particular dataset specifi- 

cation included more switches than would fit in the 
space provided; or 

c. 3, which means (b) , but this particular dataset specifi- 
cation included more switches than would fit in the 
space provided. 

If there are no more dataset specifications and the user 
requests one anyway, a null specification will be returned. 

Bit 2, when set to one, indicates that the device name in 
the Link Block is a default supplied by the system (see 
Section 3.4.1) . 

• With respect to values returned in the Link Block (Figure 3-6) 

If the PHYSICAL DEVICE NAME word is zero, the user does not 
wish this particular output (input) dataset to be generated 
(read); i.e., this entry was omitted when the command 
string was typed. If not zero, the PHYSICAL DEVICE NAME and 
UNIT NUMBER are appropriately set to the device and unit 
specified in the command string. 

• Immediately following the PHYSICAL DEVICE NAME word in the 
Link Block are the switches specified in the command string. 
The interface for each switch is shown in the switch block 
below. These switch blocks are written in the area provided 
by the programmer in the Link Block. Note that the number 
of words to follow in the switch block is not the same 
quantity as is specified in the LINK Block. 


NUMBER OF WORDS TO FOLLOW 

POINTER TO FIRST CHARACTER OF Vn 
POINTER TO FIRST CHARACTER OF Vn-1 


POINTER TO FIRST CHARACTER OF VI 


W (ASCII) 


S (ASCII) 


; for /SW 
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r»CTO t 4- \ 

m A- V ^WJ. J. u ; 


j-j. munaJjA kj e vVUxvuo iu ru±jijuvv xs zero, tnere are no more 
switches. Note that the pointers are in reverse order. 

After the value pointers are the ASCII bytes which contain 
the first two characters of the switch. The first character 
is in the low byte, and the second is in the high byte. If 
the name of the switch contains only one character, the 
ASCII representation of that character will be in the low 
byte, and the high byte will contain a zero. Note that if 
the NUMBER OF WORDS TO FOLLOW is not zero, it is the number of 
values +1 . For example , if the switch / SWITCH : $ 12 : AB is 
stored in memory beginning at location 1000 as: 


1000 

/ 

1001 

S 

1002 

W 

1003 

I 

1004 

T 

1005 

C 

1006 

H 

1007 

1010 

$ 

1011 

1 

1012 

2 

1013 

1014 

A 

1015 

B 


then the completed interface appears as: 



• With respect to the values returned in the Filename 

Block (Figure 3-7): 

a. The FILENAME occupies the two words at FILBLK and 
FILBLK+2. If the Monitor returns zero at FILBLK, no 
filename was specified in the dataset specification; 
if it returns 52g at FILBLK, * was specified as the 
filename. Otherwise, the Monitor returns at FILBLK 
and FILBLK+2 the first six characters of the filename 
specified, in Radix-50 packed ASCII. 

b. The EXTENSION occupies the word at FILBLK+4. If the 
Monitor returns zero at FILBLK+4, no extension was 
specified; if it returns 52g, * was specified. Other- 
wise, the Monitor returns the first three characters of 
the extension specified, in Radix-50 packed ASCII. 

c. The USER IDENTIFICATION CODE occupies the word at 
FILBLK+6 . If the Monitor returns zero at FILBLK+6, no 
UIC was specified in the dataset specification (the I/O 
processors will assume the UIC of this user) . If a UIC 
was typed in, the Monitor will set this word appropriately. 
The Monitor returns 377 g in the high- or low-order byte 

of this word if * was specified in either of those positions. 

The user may restart at the beginning of the input data- 
set or output dataset side of the command string simply 
by recalling .CSI1 and issuing a 0 or 2 code, respec- 
tively. Note that he may not restart one without re- 
starting the other. 


Remark : There is no error checking with respect to magnitude 

when the UNIT or UIC values are converted from octal ASCII to binary. 
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LINK Block 

3 . 9 USER PROGRAM TABLES AND CONTROL BLOCKS 


3.9.1 The Link Block (used for all input/ output and directory requests) 


LNKBLK : 


ERROR RETURN ADDRESS 


000000 LINK POINTER (for Monitor use only) 


LOGICAL NAME OF DATASET — Rodix-50 Packed ASCII 


UNIT NUMBER 


NUMBER OFWORDS TO FOLLOW 


PHYSICAL DEVICE NAME -- Radix-50 Packed ASCII 


Figure 3-6 The Link Block 

Each dataset in a user's program must have a Link Block associated 
with it. Entries in the Link Block which must be specified by the 
user can be written into his program or set by the program itself 
before the dataset is INITed. Each entry is explained below. 

Address Name Function 


LNKBLK- 2 


LNKBLK 


LNKBLK+2 


ERROR RETURN 
ADDRESS 


LINK POINTER 


LOGICAL NAME 
OF DATASET 


This entry must be set by the user to 
contain the address where he wants to trans- 
fer control in the event that any request 
associated with this dataset fails to 
obtain required buffer space from the 
the Monitor. If no address is speci- 
fied here, such an error will be treated 
as fatal. This address may be changed 
by the user's program at any time. 

This location must be set to zero by 
the user and must not be modified by 
him. The Monitor places a linking ad- 
dress here when the dataset is INITed. 
Before INITing a dataset, the Monitor 
tests this pointer for zero. If it is 
not zero, the Monitor assumes that the 
dataset was already INITed. 

The user can specify a name for the dataset 
in this entry. This name, which must be 
unique, is used to associate the dataset 
with a device which is specified by an 
ASSIGN from the keyboard. The name is 
stored in Radix-50 packed ASCII by the 
. RAD 50 assembler directive. This speci- 
fication is optional, but if it is omitted, 
the ASSIGN command cannot be used. 


LNKBLK+4 NUMBER OF This byte contains the count of the number 

WORDS TO of words to follow in the Link Block. The 

FOLLOW user should set it to a 0 if he does not 

specify any PHYSICAL DEVICE NAME in the 
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. LNKBLK (cont) 


Address Name Function 

next word, or to a 1 if he does. Values 
greater than 1 may be used if the Com- 
mand String Interpreter is to be called. 

LNKBLK+5 UNIT NUMBER This code specifies the unit number of the 

device linked to the datasets For ex ample 
the TC11 Controller (DEC tape) can drive up 
to eight tape drives (units) , numbered 

0-7 . 

LNKBLK+6 PHYSICAL 

DEVICE NAME If the user specified 1 or greater in byte 

LNKBLK+4 , he may specify here the standard 
name (Appendix A) for the device associated 
with the dataset in Radix-50 format. If no 
name is specified here, the user must specify 
LOGICAL NAME OF DATASET and perform an 
ASsign command before he runs his program. 

If physical device name is specified 
both here and in an ASSIGN command, the 
device specified in the ASSIGN command 
overrides the value given here. 


LNKBLK+8 OPTIONAL 

through DATA 

LNKBLK+n 


Present only if LNKBLK+4 is greater than 1 
It is used to pass additional information 
such as switch information when using the 
Command String Interpreter or Resident 
EMT information when using .RUN, via the 
Link Block. 
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FILENAME Block 

3.9.2 The Filename Block 


Each file associated with a dataset 
must be described by the user in a Filename Block. If a dataset is 
not a file, the Filename Block must still be used (if .OPEN is used) 
but FILENAME, EXTENSION, AND PROTECT need not be specified. The file- 
name Block is used by OPEN and all directory management requests. 


ERROR RETURN ADDRESS 

ERROR CODE 

HOW OPEN 

RLE 

NAME 

FILE 

NAME 

EXTENSION 

USER ID CODE 

(spare) 

PROTECT CODE 


Figure 3-7 The Filename Block 


Address Name Function 


FILBLK-4 ERROR RETURN ADDRESS The user must specify here the 

address to which he wants the 
Monitor to return control if one 
of the errors in Table 3-4 occurs 
during an operation involving the 
file. If no address is specified 
here, any such error will be trea- 
ted as a fatal error. 

3. 9.2.1 Error Condition Codes (FILBLK-1) 


Table 3-4 

Filename Block Error Conditions 


Error Code 
In File- Faulting 

name Block Request Cause Remedy 


00 

.OPENC 
. OPENE 
.OPENI 
.OPENO 
.OPENU 

An attempt was made 
to open a dataset 
that was previously 
opened . 


01 


unused 



(continued on next page) 
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.OPENC 
.OPENE 
.OPENI 
, OPENU 



, OPENC 
, OPENE 
, OPENI 
.OPENU 


OPENC 

OPENE 

OPENU 




OPENC 
OPENE 
OPENI 
, OPENO 
.OPENU 
, RUN 





. OPENC 
.OPENE 
, OPENO 
, OPENU 


.ALLOC 

.OPENO 





to opGii 5 me 
which already 
exists. 


An attempt was made 
to open a file 
for input, exten- 
sion, or update 
which is currently 
opened for output, 
or which does not 
exist. 


The file specified 
was already OPENed 
for output, or the 
file does not exist. 


An attempt was made 
to open a file which 
has already been 
opened the maximum 
number of times 

< 7 V- 


An .OPENC, .OPENE, 
or .OPENU attempt 
was made to open a 
file which has al- 
ready been opened 
for either .OPENC, 
.OPENE, or .OPENU. 


Illegal request to 
a contiguous file. 


An attempt was made 
to access a file 
which the protection 
code prohibits. 


Illegal OPEN re- 
quest to a contigu- 
ous file. 


File opened for 
output or extension 
is already on cur- 
rent DECtape unit. 


Directory full (DT). 


If name of file was 

^ ^ ~ j- ~ 1 ~ 4 - ^ 

^ ■*- w's- L. / "'J. ■ — L.ii’tr 

file (with PIP) or 
change file name. 



.CLOSE the previous 
open . 



Resolve access pro- 
blem with owner of 
the file. 



Close offending file, 


Mount another DEC- 
tape. 


(Continued on next page) 


3-83 























Table 3-4 (Cont) 
Filename Block Error Conditions 


Error Code 

In File- Faulting 

name Block Request Cause Remedy 


13 

.ALLOC 

The UIC was not 
entered into the 
device MFD. 

Enter UIC via PIP. 

14 

. APPND 
.DELET 
.REN AM 

An attempt was made 
to perform an 
illegal operation 
on an opened file. 

Wait until file is 
closed. 

15 

.ALLOC 

.OPENO 

An attempt was made 
to create a file 
with an illegal 
file name. 

Change file name. 

16 

.RUN 

All datasets were 
not released prior 
to issuing the re- 
quest. 

Release all datasets 
which were INITed. 

17 

.RUN 

Load module format 
error . 

File must be linked 
into a load module. 

20 

.RUN 

Specified CIL entry 
not found. 

Add proper entry to 

CIL or use correct 

name. 

21 

• RUN 

No transfer address 
or illegal trans- 
fer address. 

Check for END state- 
ment in source pro- 
gram, or use correct 
/TR when linking. 

22 

.RUN 

Stack base entry in 
the System Vector 
Table (SVT) is 
below the Stack 
Pointer. Stack can- 
not be moved as 
requested in the 
call. 

Probably a program 
error . 

23 

.RUN 

Module is outside 
the boundaries 
of the allowable 
load area. 

Relink to within 
boundaries. Ensure 
that resident portion 
of program is not 
being overlayed. 
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Address Name Function 

FILBLK-2 HOW OPEN This is set when the .OPENx macro's 

assembly language expansion is executed. 
It tells the Monitor which kind of open 
is being requested: .0PENU=1, .0PEN0=2, 
. OPENE=3 , .0PENI=4 , .0PENC=13. 


Th is - e ntry - should not be set by th e-^user • 
It will be set by the Monitor to indicate 
the type of error (Table 3-4) which 
occurred. It will be cleared of any 
previous condition at each .OPEN call. 


FILBLK+0 

FILBLK+2 


FILBL.K+4 


FILBLK+6 


FILE NAME 


EXTENSION 


This two-word entry must be specified by 
the user if this dataset, or a portion 
thereof, is a file. It is the name of 
the file, in packed Radix-50 format. 

This entry must be specif red rf the file 
named in the previous entry has an ex- 
tension. It is in packed Radix-50 format. 


USER I.D. CODE The user may enter his USER ID CODE here 
in octal: 


FILBLK+10 PROTECT 
CODE 


GROUP NUMBER USER'S NUMBER 


High-Order Byte 


Low-Order Byte 


If no entry is specified here, the 
current user's UIC is assumed. 


The user may specify here the protection 
to be given to the file at its creation 
or renaming (see following paragraph) . 

If 0, a default protection 233 will be 
allotted . 
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3. 9.2.2 The File Protection Codes 


7 

6 

5 

4 

3 

2 

1 

0 

Owner 

User Group 

All Others J 


Owner: Bit 6=1= Owner cannot write on or delete the 

file. This is a safeguard to prevent 
inadvertent deletion or over-writing. 

Bit 7=1= Protect the file from automatic deletion 
on Finish. 


Figure 3-8 File Protection Codes 


User Group and All Others 


Function 


Code 

Delete 

Write 

Read 

Run 

0 

1 

yes 

yes 

yes 

yes 

yes 

yes 

y es - — 

2 or 3 

4 or 5 



yes 

yes 

Y es - 

6 or 7 






Note; yes indicates that the operation is allowed. For 
example, if a file belongs to user [23,10] , a pro- 
tection code of 3 will allow user [12,4] to read or 
run but not delete or write on it. 

Figure 3-8 File Protection Codes 
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3.9.3 The Line Buffer Header 


(used by READ and WRITE requests) 


BUFHDR : 


MAXIMUM BYTE COUNT 


STATUS 

MODE 

ACTUAL BYTE COUNT 

POINTER (Dump i 

Mode only) 


Figure 3-9 Line Buffer Header 


Each element of the line buffer header table is as follows: 


Address Name 


Function 


BUFHDR 


BUFHDR+2 


BUFHDR+3 


BUFHDR+4 


BUFHDR+6 


MAXIMUM BYTE 
COUNT 

MODE 


The count shows the size of the buffer, 
in bytes. It must be specified here by 
the user on all INPUT operations. 

The user specifies here the mode of the 
transfer. All modes are listed and ex- 
plained in Figure 3-10. 


STATUS 


ACTUAL BYTE 
COUNT 


POINTER 
(dump mode) 


The Monitor will place in this byte the 
status of the transfer when control is 
returned to the user. Figure 3-11 lists 
each bit and its meaning. Errors encoun- 
tered executing an I/O transfer will be 
flagged in this byte. The user should 
always check its content after each trans- 
fer completes. 

This count controls the number of bytes to 
be transferred on OUTPUT. It must be 
initialized by the user before any output 
transfer from the line buffer. After any 
transfer in or out, it will show how 
many bytes have been transmitted (or in 
some modes, see Section 3.6, would have 
been transferred had some error not been 
detected ) . 

If bit 2 of MODE is 1, the user specifies 
here the starting address of the line 
buffer. If bit 2 of MODE is 0, the line 
buffer header is only three words in length, 
and must immediately precede the line 
buffer itself. (Section 3.9.6 Note 9.) 


NOTE 

The Monitor will return control to the program 
if a device transfer is needed to satisfy a READ 
or WRITE request. During this time, the header 
words will be used to store data relevant to the 
operation underway. The user should not, there- 
fore, attempt to change this content until it is 
evident that the transfer has been completely 
effected, e.g. , after a .WAIT return. 
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0 = ASCII 


i Reserved 

Set to 1 to suppress for 

automatic echo on RSX 

a terminal (keyboard) 
device. 


1 = Binary 

0 = Formatted 

T - Unformatted 

0 = Data follows Header 

1 = Dump 
0 = No Parity 

1- Parity (indirect) 

0 - Normal 

1 = Special 


Figure 3-10 The Mode Byte 


3. 9 . 3.1 The Transfer Modes - The user can specify ASCII or binary 
data in nine different modes of transfer: 

ASCII Modes: Formatted ASCII Parity - Special 
Formatted ASCII Parity - Normal 

Formatted ASCII Nonparity - Special 
Formatted ASCII Nonparity - Normal 

Unformatted ASCII Parity - Special 
Unformatted ASCII Nonparity - Normal 

Binary Modes: Formatted Binary - Special 
Formatted Binary - Normal 

Unformatted Binary - Normal 

1. Formatted ASCII Norma l - Data in this mode is assumed by 

the Monitor to be in strings of 7-bit ASCII characters termi- 
nated by LINE FEED, FORM FEED, or VERTICAL TAB. 

READ: The line buffer is filled until either a terminator 

is seen or the number of bytes transferred becomes 
equal to the MAXIMUM BYTE COUNT. If the MAXIMUM 
BYTE COUNT is reached before the terminator is 
seen, the invalid line error bit in the Status 
Register of the buffer header is set, and each re- 
maining character through to the terminator is read 
into the last byte of the line buffer, i.e., the 
surplus bytes are overlayed. After the transfer, 
the actual byte count is set to the number of bytes 
read (including the excess) . RUBOUTs and NULLs are 
discarded. The terminator is transferred. LINE 
FEED is supplied after RETURN. 


WRITE: The line buffer is output until the number of bytes 

transferred equals the ACTUAL BYTE COUNT. If the 
last character is not a terminator, the invalid line 
error bit is set in the STATUS BYTE of the buffer 
header. Previous terminators are output as normal 
characters. 
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For non file-structured devices, TABs are automatically followed 
by RUBOUTs; FORM FEF.Ds are automatically followed by NULLs. 


The READ/WRITE processor passes data to the device driver 
specified, and each driver will convert the information to 
meet its specific needs. Appendix G summarizes the charac- 
teristics of the device drivers. Normally, output is deferred 
until the current buffer is full or until a .CLOSE or . RLSE 
occurs. However, for terminal devices, the buffer is written 
when a line terminator is seen. VERTICAL TAB plays a special 
role here, since it is a terminator but does not cause a 


2 . Formatted ASCII Special - 

READ : The same as formatted ASCII normal with this ex- 
ception: if the MAXIMUM BYTE COUNT is reached be- 

fore the terminator, the transfer is stopped. 

The remaining characters are not overlaid, but are 
retained for transfer at the next .READ . An invalid 
line error will be returned in the STATUS BYTE, and 
ACTUAL BYTE COUNT will equal MAXIMUM. 

WRITE : The same as formatted ASCII normal with this excep- 
tion: the line buffer is output until the first 

terminator; the ACTUAL BYTE COUNT will stop the 
transfer if it is reached before the terminator is 
seen. In this case, the invalid line error bit is 
set in the STATUS BYTE. Note that in this mode only 
one line of data can be output at once, but its 
byte count need not be exactly specified, provided 
it is not greater than the ACTUAL BYTE COUNT. 

3 . Formatted Binary Norma l - 

REAP : This is an 8-bit transfer. Words 2 and 3, STATUS/ 

MODE, and ACTUAL BYTE COUNT always accompany 
the data during formatted binary transfers. The 
counts are adjusted by the Monitor to include the 
extra words. On input, the line buffer is filled 
until the number of characters transferred equals 
the ACTUAL BYTE COUNT read, or the MAXIMUM BYTE 
COUNT. If the MAXIMUM is reached before the ACTUAL, 
an invalid line error occurs and the remaining 
bytes are overlaid into the last byte until the 
checksum is verified. After the transfer, the 
ACTUAL BYTE COUNT contains the actual number of data 
bytes read (including the excess). 

WRITE : This is an 8-bit transfer. Words 2 and 3 of the 
line buffer header are output, and data is trans- 
ferred until the number of characters transferred 
is equal to the ACTUAL BYTE COUNT; then a checksum 
is calculated. The checksum is output at the end. 

The byte count is adjusted to reflect the presence 
of words 2 and 3 from the line buffer header. 


READ: 


The line buffer is filled until the number of charac- 
ters transferred equals the ACTUAL BYTE COUNT read. 

If the MAXIMUM COUNT is reached before the ACTUAL, 
the remainder of the line is retained by the Monitor. 
The MAXIMUM BYTE COUNT is transferred to the line 
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buffer and the ACTUAL BYTE COUNT is set to the full 
input count, rather than to the number of bytes 
actually transferred. The invalid line error will 
be set in the STATUS BYTE. The user can compare 
the MAXIMUM COUNT with the ACTUAL, determine how much 
data remains, and recover it by an unformatted binary 
read (allowing 1 extra byte for the checksum) . 

WRITE : Identical to formatted binary normal 

5. Unformatted ASCII Normal or Special - This mode is available 
to the user who wants to do his own formatting. Seven bits 
are transferred; the eighth is always set to zero. NULLs 
are discarded. 

READ : Transfer stops when the number of bytes transferred 

reaches the MAXIMUM BYTE COUNT. Nulls are discarded 
but all other characters are treated as valid. 

WRITE: All characters are transferred. The transfer stops 

when the ACTUAL BYTE COUNT is reached. 

6- Unformatted Binary Normal or Special - This mode is identi- 
cal to unformatted ASCII except that eight bits are transferred 
on both input and output and nulls are not discarded. No 
checksum is calculated. 

7. Formatted ASCII Parity - Identical to formatted ASCII 

(Special or Normal) except that even parity is generated in 
the eighth bit on OUTPUT; during INPUT it will be checked. 

Valid characters will be passed to the user as 7 bits; 
invalid characters will be marked by bit 8=1, and will 
cause the setting of the parity error bit in the STATUS BYTE. 

8* Unformatted ASCII Parity - Identical to unformatted ASCII 
(Special or Normal) except that eight bits are transferred 
instead of seven. No parity generating or checking is per- 
formed. 

9. Indirect Modes - All modes can be specified as indirect, 
which means that the word after the ACTUAL BYTE COUNT is 
considered to be a pointer to the beginning of the data 
rather than the beginning of the data proper. (Section 
3.9.4.) This is referred to as DUMP mode. 
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3. 9.3. 2 


The Status Byte 



Figure 3-11 Status Byte Format 
The function of each status format bit is explained below. 


Bit 

Mode 

Request 

Condition 


ALL 

. READ/WRITE 

Appropriate BYTE COUNT = 0 

1 

LA, U. L/UA A • 

0 

(INVALID 

LINE) 

FORMATTED 
ASCII NORMAL 
(parity or 
non-parity) 

.READ 

The MAXIMUM BYTE COUNT ran 
out before a line terminator 
was seen. (Last byte has 

been overlaid until the termi- 
nator has been reached.) 



.WRITE 

The last byte was not a 
terminator . 


FORMATTED 

ASCII 

SPECIAL 
(parity or 
non-parity) 

.READ 

The MAXIMUM BYTE COUNT was 
reached before a line 
terminator was seen (excess 
data has not yet been read) . 



.WRITE 

The ACTUAL BYTE COUNT was 
reached before any terminator 
was seen. 


FORMATTED 

BINARY 

NORMAL 

.READ 

The MAXIMUM BYTE ran out 
before the count stored with 
the data. (The last byte 
has been overlaid in order 
to verify the checksum. ) 


FORMATTED 

BINARY 

SPECIAL 

.READ 

The MAXIMUM BYTE COUNT was 
reached before the count 
stored with the data. (The 

excess data still remains to 
be read and checksum has 
not been verified.) 


ALL 

UNFORMATTED 

MODES 

.READ 

BYTE COUNT = the actual number 
of bytes transferred. The 
reason BYTE COUNT < MAXIMUM 

BYTE COUNT is that an EOF or 

EOM has been encountered before 
the buffer was full. Bit 6 
will also be set. 

1 

(CHECKSUM 

ERROR) 

FORMATTED 

BINARY 

. READ 

There was a discrepancy be- 
tween the checksum accumulated 
during the .READ, and that 
stored with the incoming data. 
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2 

(PARITY 

FORMAT) 


2 

(ILLEGAL 

BINARY 

FORMAT) 


& 

(EOM/EOF ) 


5 

(DEVICE 

PARITY) 


FORMATTED . READ 

ASCII PARITY 
NORMAL OR 
SPECIAL 


A character was read which had 
odd parity. The eighth bit of 
the illegal character delivered 
is set to a 1. The transfer 
continues. If this bit is set 
the user need only check each 
character returned during proc- 
essing of the buffer for bit 8 
set to locate the character re- 
turned with wrong parity. 


FORMATTED .READ This bit is set if a line proc- 

B INARY essed in a binary mode does not 

have a 001 in the first word. 

The first word is ignored, i.e., 
no data is returned to the buf- 
fer. Subsequent reads access 
successive lines and return 
error bits or data as appro- 
priate. 


ALL MODES .READ or An input device cannot supply 

.WRITE any more data or an output de- 

vice cannot accommodate more, 
i.e., the disk has no more 
storage space, or the paper 
tape reader has run out of 
paper tape. No data is re- 
turned on .READs unless bit J0 
is also set (see bit J0) . On 
.WRITES an unspecified por- 
tion of the buffer may have been 
written (enough data to fill a 
partially filled monitor buffer 
may have been transferred to 
the buffer and written before 
the EOM or EOF was detected) . 
Subsequent requests return to 
user with this bit set. 

ALL MODES .READ or 

.WRITE A hardware error has been de- 

tected on a bulk storage device. 
This could be either a parity 
error or a timing error. The 
driver will already have tried 
to READ or WRITE 8 or 9 times 
before setting this bit. (This 
flag is a warning that the data 
in this line or some subsequent 
line still using data from the 
same device block may be invalid. 
It will be returned for each 
transfer call using the same 
block . ) 
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RECORD Block 


3.9.4 The 


ADDRESS 

RECBLK 


RECBLK+2 


RECBLK+4 

RECBLK+6 

RECBLK+1J0 


RECORD Block 


RECBLK: 


FUNCTION / STATUS 

BUFFER ADDRESS 

RECORD LENGTH 
HI ORDER. RECORD # : 

LQ ORDER . RECORD XU 


Figure 3-12 The Record Block 
FUNCTION 


FUNCTION / STATUS WORD 


BIT 

0 - Not used 

1 - Record Output - Set by user 

O _ V T vm 4- — 4- Utt 

4^ JL su XI ipuu UC I— ubcj. 

3-8 - Not used 


(Following bits set by Monitor) 

9 - Illegal Function 

1J0 - File is linked or device is not File structured. 

11 - Record requested lies outside the file. 

12 - File not OPEN 

13 - Protect code violation. Incorrect Open 

14 - Not used 

15 - Device parity error 

The user may set only bits 1 or 2; error bits are set 
by the Monitor, and should be tested for by the user 
upon return from the request. The error bits are 
cleared by the Monitor when a .RECRD request is issued 
and are set as appropriate upon return from the Monitor. 

BUFFER ADDRESS 


The address of the user's buffer. The buffer must 
be large enough to contain a record of the length 
indicated in the next word, as the Monitor assumes that 
sufficient space is available and will overlay data 
stored below a buffer of insufficient length. 

RECORD LENGTH 

The number of bytes of a Record. This value, which 
must remain the same for all records in the file, is 
supplied by the user. 

High Order - Record Number 
Low Order - Record Number 


This entry identifies the record to be read or 
written. Two words are provided in anticipation of 
files with more than 65,536 records. 

First Record of File is number 0 . 
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BLOCK Block 


3.9.5 The 


Address 

BLKBLK 


BLKBLK+2 

BLKBLK+4 

BLKBLK+6 


BLOCK Block - (used by BLOCK request only) 


BLKBLK: 


FUNCTION/STATUS 
SLOCK NUMBER 
MEMORY BUFFER ADDRESS 
LENGTH 


Figure 3-13 The BLOCK Block 


Name 


Function 


FUNCTION/STATUS User specifies here the function to be 

performed, and the Monitor returns to 


the 

set. 

user 

with the appropriate status bits 

Bit 


Bit = 1 means: 

f 

0 

function is GET 

u 



n 



c 

1 

function is OUTPUT 

t 



i 



o 

2 

function is INPUT 

n 

3- 

-8 reserved 

e 

9 

illegal function 

r 

10 

file is linked, or device is 

r 


not file structured 

o 


r 

11 

block number does not exist 
in file, i.e., it is greater 
than the file length 

s 

t 

12 

file not open 

a 

13 

protect code violation 

t 

14 

end of data error 

u 



s 

15 

device parity error 


BLOCK NUMBER Requested block number to be transferred 

relative to the beginning of the file. 

First block of file is 0. 


MEMORY BUFFER The address of the buffer (supplied 

ADDRESS by the Monitor on INPUT or GET func- 

tions ) . 


LENGTH The length of the buffer in words. 

BLKBLK+6 is set by the Monitor on 
INPUT or GET functions . 
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TRAN Block 


3.9.6 


The TRAN Block (used by TRAN request only) 


TRNBLK: 


DEVICE BLOCK NUMBER 
MEMORY START ADDRESS 
POSITIVE WORD COUNT 
F UNC T I ON / S TATU S 

NUMBER OF WORDS NOT TRANSFERRED 


Figure 3-14 The TRAN Block 

The user must set up a TRAN block for each .TRAN in his program. 


Address 


Name 


Function 


TRNBLK 


TRNBLK+2 

TRNBLK+4 


TKNBLK+6 


DiiVICUi tsLOCK 
NUMBER 


BUFFER 

ADDRESS 


User specifies here the absolute block num- 
ber of the device, at which the transfer is 
to begin. Block 0 is the first block on 
bulk storage devices. If it is not a bulk 
storage device, specify block 0. 

User specifies here the core memory address 
at which the data transfer is to begin. 


WORD COUNT User specifies here the total number of 

16-bit words to be transferred. Word 
count may be more or less than block 
size. 


FUNCTION/ STATUS Bit 


Bit Meaning 


0 Binary =1, as opposed 

to ASCII =0 

1 Write = 1* 

2 Read = 1* 


3 

4 


-j Reserved for Monitor's use 

8 

9 

10 


11 

DECtape direction* 

0 = forward 


1 = reverse 

12 

Reserved for RSX-11 

13 

Invalid call (improper 
function/no word count) 

14 

End of medium** 


*Must be specified by user. 

* *This bit is cleared by the Monitor upon .TRAN request issue and is 
set as appropriate upon return. 
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Address 

Name 


Function 



Bit 

Bit = 1 means: 



15 

Recoverable device error 
(such as parity, timing, or 
record length)** 

TRNBLK+10 

NUMBER OF 

WORDS NOT 
TRANSFERRED 

User leaves this entry blank. If an 
EOM occurs during the transfer, the 
Monitor will place in this entry the 
number of words not transferred. 


**This bit is cleared by the Monitor upon .TRAN request issue and is 
set as appropriate upon return. 
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Special Functions Block 


3.9.7 The Special Functions Block (used for SPEC request only) 
SPCBLK: 


WORDS TO FOLLOW 


CODE 


ADDITIONAL DATA 
WORDS AS NEEDED BY 

riJ Pnv- i IL/iN jKEUii’iCU 


Figure 3-15 


Where a special function requires supporting data the user must set 
up a Special Functions Block in his program. 


Address 

SPCBLK 

SPCBLK+1 


Name 

CODE 

WORDS TO 
FOLLOW 


SPCBLK+2 


Function 

The user identifies the function here by 
inserting the appropriate code in the 
range 0-255^. 

The size of each Special Functions 
Block is dependent upon the Function. 

The user shows here how many more 
words belong to the particular block. 

The user places in these words data to 
be passed to the function processor or 
the function processor will return here 
such items as status information, etc. 
The format in each case is determined 
by the function. 


See Appendix J for a description of the special functions which may 
be performed for each device. 
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.RUN Block 


3.9.8 The RUN Block 

The RUN Block is used exclusively with the .RUN request. It is 
a variable length control block containing a function word and several 
parameter words. The function word is always present; any of the 
parameter words may be omitted, depending upon the settings of the 
function word. 


NOTE 

Omitting a parameter word does not mean setting 
it to zero, but rather leaving it out. Hence, 
no parameter word occupies a set position in the 
RUN Block and the block itself is of variable 
length. For reference, all words but the func- 
tion word are referred to by a letter, not by a 
number . 


Word Parameter Present If : 


1 

FUNCTION WORD 

always 



A 

FILE BLOCK POINTER 

Bit 

15=0 



B 

LINK BLOCK POINTER 

Bit 

15=0 



C 

NAME 

Bit 

15=1 or 

Bit 

13 = 1 

D 

NAME 

Bit 

15=1 or 

Bit 

13=1 

E 

LOAD ADDRESS 

Bit 

3 = 1 



F 

TRANSFER ADDRESS OFFSET 

Bit 

4=1 



G 

RETURN ADDRESS 

Bit 

5=1 




* Words A through G are so designated because any of 
them might be omitted under certain conditions. 


Figure 3-16 The RUN Block 


Address Name 

RUNBLK FUNCTION 

RUNBLK+A FILE BLOCK 


RUNBLK+B LINK BLOCK 


Function 


User specifies here the function to be per- 
formed (see below) . 

Address of the File Block describing the file 
which contains the load module or core image 
to be loaded. 

Address of the Link Block which describes 
the device from which the entity is to be 
loaded. Sufficient room must be provided in 
the Link Block to contain the EMT numbers of 
all Monitor modules which are to be loaded 
(these are contained in the load module, if 
there are any) . 
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Address Name Function 

RUNBLK+C NAME Two Radix-50 words containing either the name 

and RUNBLK+D of the specific core image to be loaded from 

a CIL (bit 13=1) or the name of the file to 
be loaded if no File Block was given 
(bit 15=1) . 

RU NB LK+E LOAD AD D RE S S Specifies an address at wh i ch t he e nt i ty is 

TGG D6 iCaucu / Wi luCuu jTS'JcLZ’G. "CO luc JLOciCl a. CL “ 

dress in the load module or CIL. The entity 
should be position independent. 

RUNBLK+F TRANSFER Specifies a value to be added to the transfer 

ADDRESS address obtained from the load module or CIL. 

OFFSET Provides for alternate entry points to the 

module. 

RUNBLK+G TRANSFER Specifies an address to which control must be 

ADDRESS passed when loading is completed. This 

address may or may not be in the loaded entity. 


3. 9. 8.1 The Function Word 



Transfer of Control 

Figure 3-17 The Function Word 
Bit jL 5 Argument Return and Transfer of Control 

=j? Indicates control is to be returned to the instruction 

following the .RUN request after completing the requested 
actions, unless bit 5=1. Regardless of the setting of bit 5, 
the load module's transfer address, size in bytes, and low 
address will be on top of the stack when bit j£f=j0 (see 
Section 3 . 8. 1. 1) . 

=1 Indicates control is to be switched to the transfer address 
of the loaded module after completion of the load, unless 
bit 5=1. Regardless of the setting of bit 5, no information 
is returned on the stack when bit 0=1, but information may 
be passed by the call to the loaded module either on the 
stack or in the general registers. 
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Bit 1 


Stack Movement 


=0 

=1 


Bit 2 

=J0 


= 1 


Bit 3 

= 1 


Bit 4 

=pr 

=1 


Bit 5 

=0 

= 1 


Bit 12 


Bit 13 


Indicates that the stack is not to be moved from its pres- 
ent position under any condition. 

Indicates that stack relocation may be necessary and that 
bit 2 of this word must be tested to determine under what 
conditions relocation will be necessary. 

Movement Condition 

Indicates that the stack is to be unconditionally moved to 
the area directly below the module to be loaded. In this 
position the stack base entry in the System Vector Table 
(SVT) will be the same as the low address of the loaded 
module. 

Indicates that the stack is to be conditionally moved, 
based on the relative positions of the stack base and low 
address of the module to be loaded. If the stack base 
entry in the SVT is higher than the low address of the 
module to be loaded, then the stack should be relocated as 
described above. If the stack base entry in the SVT is 
lower in core or equal to the low address of the module to 
be loaded, then the stack will not be relocated. 

Load Address 

Indicates that no optional load address is specified in the 
RUN Block. The load address information in the load 
module will be used. 

Indicates that the address specified in the RUN Block is 
to be used as the load address for the requested module. 
This entry overrides the load module information. 

Transfer Address Offset 

Indicates that no offset from the module's transfer address 
is included in the RUN Block. 

Indicates that the user desires an offset, specified in 
the RUN Block, to be added to the loaded module's transfer 
address. This offset is added to the transfer address 
regardless of the setting of bit 0 of the action word. 

Return Address 

Indicates that no alternate return address is included in 
the RUN Block. Return of control will thus be determined 
by the setting of bit 0. 

Indicates that an alternate return address has been speci- 
fied in the RUN Block and that this address will receive 
control instead of the address following the .RUN request 
or the transfer address of the load module. The setting 
of bit 0 will still determine whether information will be 
returned on the stack. 

Reserved for Monitor 

This bit should always be zero. 

Load Module/Core Image 

Indicates that the entity being loaded is a load module. 

If the file identified by the File Block is a CIL, the 
first member of the CIL will be loaded. 
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Bit 13 ( cont inued ) 


=1 


Bit 14 

= 0f 


= 1 


Bit 15 

=j0 
= 1 


Indicates that the entity to be loaded is a member of Core 
Image Library. The File Block identifies the CIL, while 
words 4 and 5 of the RUN Block contain the name of the 
CIL member. 

Overlay/Program 

Indicates that an overlay is being loaded. Since this is 
a continuation of the curren t program ^ datas e ts may b e Left 
open across this call. The overlay may not extend above 
the low address of the resident module, nor may it extend 
below the top of the Monitor area. System control tables 
are not refreshed as a consequence of this call. No addi- 
tional Monitor modules may be made resident. 

Indicates that a new program is being loaded. This is as 
if a new program were being RUN from the keyboard. Although 
all datasets must be released by the program which called 
RUN, RUN itself will do several things to refresh the 
environment. This includes releasing Monitor modules made 
resident by the previous program, undoing dataset assign- 
ments made specifically for the previous program, loading 
any Monitor modules which should be resident for this pro- 
gram, and changing any program-related values in the SVT. 

File Block, Link Block 

Indicates that a Link Block and a File Block pointer are 
in the RUN Block. 

Indicates that the caller has provided a short form of the 
RUN Block; the short form contains only a function word 
and a six-character filename. The Link Block and File 
Block are created by the .RUN request itself. The entity 
to be loaded must be either in the current user's area 
or in the [1,1] UIC area and must have an extension of 
LDA or null. All other function bits are ignored. The load 
module or core image (first member of CIL) is loaded at 
its normal load address, as if it were an overlay, and 
receives control at its normal transfer address. The stack 
is not moved. 


The following flowchart illustrates the effects of the various 
function word bits and their interrelationships. 
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TRANSFER ADDR 
= INSTRUCTION 
FOLLOWING .RUN 
REQUEST 


Load new module 

SET CA = TO 
TRANSFER ADDR 
SPECIFIED IN 
LOAD MODULE IK 
POMP 
























APPENDIX A 

PHYSICAL DEVICE NAMES 


Mnemonic 

Device 


DC 

RC11 Disk 

014570 

DF 

RF11 Disk 

014760 

DK 

RK11 Disk 

015270 

DT 

DECtape (TCli) 

016040 

TC'R 

V ^ yU ^ /rp^l 

n a o a o n 

V £* *2 £> V 

LP 

Line Printer (LP11) 

046600 

MT 

Magtape (TM11) 

052140 

PP 

High-Speed Paper Tape Punch 

063200 

PR 

High-Speed Paper Tape Reader 

063320 

PT 

ASR-33 Paper Tape Device 

063440 

CR 

Card Reader (CR11) 

012620 

SY 

System Residence Device 

075250 


(DC, DF, or DK) 


a. Device mnemonics may be three letters on a particular 
system. The third letter is assigned if there is more 
than one controller, e.g.: 

DTA for DECtape controller "A" 

DTB for DECtape controller "B" 

b. The device name may be followed by an octal number to 
identify a particular unit when the controller has 
several device units associated with it, e.g.: 

DTI indicates unit 1 under a single DECtape 
control. 

DTA1 indicates unit 1 under controller A in 
a multicontrol situation. 


The Radix-50 equivalence is derived in accordance with the 
following formula: 

C 1 x 50 8 2 + C 2 x 50 8 + C 3 

where C n is a character (legal characters are space A-Z, 

$, period, and 1-9. These characters are assigned values 
from 0 (for space) through 47 R (for 9) . 

The following program may be used to print the octal repre- 
sentation of any 3-character set Radix-50 equivalence. To 
exit type an illegal character. 
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APPENDIX B 
EMT CODES 


EMT 

Programmed 

Described 

Code 

Request 

on Page 


0 

. WAITR 




3-36 

1 

.WAIT 




3-35 

2 

.WRITE 




3-29 

3 

2 





4 

.READ 




3-28 

5 

2 





6 

. INIT 




3-20 

7 

. RLSE 




3-21 

10 

.TRAN 




3-33 

11 

. BLOCK 




3-31 

12 

. SPEC 




3-37 

13 

. STAT 




3-38 

14 

.LOOK 




3-44 

15 

.ALLOC 




3-39 

16 

. OPENx 




3-22 

17 

.CLOSE 




3-22 

20 

.RENAM 




3-26 

21 

. DELET 




3-41 

22 

. APPND 




3-43 

24 

.KEEP 




3-46 

25 

. RECRD 




3-30 

26-27 

2 





30-31 

l 





32 

Diagnostic 

Print 


33-35 






36-37 

2 





40 

1 





41 

General 

Utilities 

3-50,-66 

42 

General 

Conversions 

3-67,-74 

43-55 

i 





56,57 

Command 

String 

Interpreter 

3-76,77 

60 

.EXIT 




3-49 

61-63 






64 

1 





65 

.RUN 




3-47 

66 

.CVTDT 




3-57 

67 

2 





68-76 

2 (70, 

reserved for Multi-User 

Operation) 

77 

l 




100-117 

(reserved 

for 

Communications Executive, COMTEX- 

120-137 

(reserved 

for 

Real-Time Monitor 

, RSX-11) 

140-167 

(reserved 

for 

user- implemented 

routines ) 


Reserved for Monitor internal communication. 
2 Reserved for future Monitor expansion. 
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APPENDIX C 

SUBSIDIARY ROUTINES AND OVERLAYS 


With the exception of .READ/. WRITE and .WAIT, all Monitor code 

for performing programmed reque s ts is potentially non-res ident. Sin ce 

non-resident modules are limited to a size of 256 words (the size of 
the swap buffer) and since many common functions are required, many 
of the programmed request modules must make use of subsidiary routines. 
The table given below can be used in two ways: 

• when assessing the number of disk accesses required 
to satisfy a request, the table shows how many mod- 
ules (in addition to the primary module) may be 
loaded; 

• when making certain functions resident, one must 
not only make the primary module resident, but 
must also make resident each of the subsidiary 
modules which may be called. For example, if one 
wants all .OPENI processing routines (except for 
magtape) resident, he would put the following assembler 
directive in his program: 

. GLOBL OPN , FOP , LUK , CKX 


The following summary explains the codes used in the table. 


(blank) = subsidiary routine is never called 

X = subsidiary routine is called only when a 

file-structured device is referenced 

L = subsidiary routine is called only when a 
linked file is referenced 

C = subsidiary routine is called only when a 

onn-f-i mimic f i To i <a t"o f 

XX »— -A- LAW WiW ^ -*• W •*» H*- -4- W ** W w ^ 

D = subsidiary routine is called only when 
DECtape is referenced 

M = subsidiary routine is called only if 
magtape is referenced 
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Name of Subsidiary Routine 


Global Name of 

Primary Module 

Request 

FQp Open Existing 

File 

15 

o <u 
3 H 

tn Em 
G 

H >d 
P <U 
X 

<a g 

SM -h 
U P 

Ph 

u 

Em 

Close 

fcl 

File 

Directory 

LUK Search 

Allocate Block, 
Linked File 

& 

flj 

s 

p p 
•H G 

m <a 
s 

p tjl 

0) <u 
O m 

3 

___ Allocate Con- 
CBA . . , 

tiguous Blocks 

Check 

CKX , 

Access 

T3 

O 

G 

•H 

<D 

P 

o a) 

rH p 

tu -h 
Q Em 

s 

Q 

Delete Con- 
DCN . . 

tiguous File 

“■ 2 n?S! nd 

DEC tape 

GNM 2 Get N6Xt Blt 

Map Segment 

a) 

& 

P G 
tn 0 ) 

3 & 
s o 

o 

u 

LDR 4 Loader 

E-l 

Q) 

'S 

0 

J- 

CN 

Q 

yl 

RWN 

.READ/WRITE 1 












X 




OPN 

.OPENU 

X 



X 




X 





M 



OPN 

.OPENO 3 


X 


X 

X 

X 


X 





M 



OPN 

. OPENE 

X 



X 

X 

X 


X 





M 



OPN 

.OPENI 4 

X 




X 



X 





M 



OPN 

.OPENC 

X 




X 



X 








CLS 

. CLOSE 4 



X 













ALO 

.ALLOC 




X 



X 

X 








DEL 

. DELET 




X 




X 

L 

C 






REN 

.RENAM 




X 




X 








APP 

. APPND 




X 




X 



D 





DIR 

.LOOK 




X 




X 








PRO 

.KEEP 




X 




X 








RUN 

.RUN 4 

X 


X 

X 




X 





M 

X 

X 

INR 

. INIT 5 
















RLS 

.RLSE 4 

















1 Always resident. 

2 Should never be made resident. 

3 The .OPENO module requires a second section if a dataset other than CMO 
is being opened on the device assigned to CMO. 

4 The .RUN EMT calls the following routines: 

. INIT 

. OPEN I (once for each combination of filename and UIC) 

. LDR (three sections if LDA file; two if CIL file) 

.LD2 

.CLOSE (once for each .OPENI) 

. RLSE 

5 The .INIT module has two sections, but the second has no name. It is 
resident automatically if .INIT is resident. 
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APPENDIX D 

SUMMARY OF MONITOR COMMANDS 


Command 


Usage 


Commands to Allocate System Resources 


ASSIGN 


Assign a physical device to a logical device name 


Commands to Manipulate Core Images 


RUN 

GET 

DUMP 

SAVE 


Load and begin a program 
Load a program 

Write a specified core area onto a device as a core 
image 

Write a program onto a device in loader format 


Commands to Start a Program 

BEGIN 

CO NTINUE 

RESTART 


Start execution of a program 

Resume execution of a halted program 

Restart execution of a previously operating program 


Commands to Stop a Program 
STOP 

WAIT 

KILL 


Halt the current program, including any I/O in pro- 
gress 

Halt current program after finishing any I/O in progress 

Halt the current program, finish any I/O in progress, 
close all open files, and pass control back to the Mon- 
itor 


Commands to Exchange Information with the System 

DATE Fetch/Specify date 

T I ME Fetch/Specify time 

(continued on next page) 

Optional characters are underlined. If any optional character appears, all must appear. 
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Command 


Usage 


Commands to Exchange Information 

LOGIN 

MODIFY 

FINISH 


with the System (Cont) 

Enter User Identification Code 
Modify contents of memory location 
Log off system 


Miscellaneous Commands 

ECHO 

PRINJ 

E ND 

ODT 


Disable/enable keyboard echo to user program 
Disable/enable teleprinter output from user program 
End input from a device 
Begin operation of Octal Debugger (ODT) 


Optional characters are underlined. If any optional character appears, all must appear. 



Global 

Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 








•ALLOC 

Allocate a Contiguous File 

•ALLOC #LNKBLK , #FILBLK , #N 

MOV #N,-(SP) 

MOV #FILBLK, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 15 


3-39 

. APPND 

Append to a Linked File 

•APPND #LNKBLK, #FIRST, #SECOND 

MOV #SECOND , — (SP) 

MOV #FIRST,-(SP) 

MOV #LNKBLK,- (SP) 

EMT 22 


3-43 

•BIN2D 

Convert Binary to Decimal ASCII 

•BIN2D #ADDR, WORD 

MOV WORD,- (SP) 

MOV #ADDR, - (SP) 

MOV #3 (SP) 

EMT 42 


3-72 

•BIN20 

Convert Binary to Octal ASCII 

•BIN 20 #ADDR, WORD 

MOV WORD , - ( SP ) 

MOV #ADDR, - (SP) 

MOV #5 (SP) 

EMT 42 


3-74 

. BLOCK 

Transfer a Block 

•BLOCK #LNKBLK, #BLKBLK 

MOV #BLKBLK , - ( SP ) 

MOV #LNKBLK,- (SP) 

EMT 11 


3-31 

. CLOSE 

Close a Dataset 

•CLOSE #LNKBLK 

MOV #LNKBLK,- (SP) 

EMT 17 


3-26 

• CORE 

Obtain Core Size 

• CORE 

MOV #100,- (SP) 

EMT 41 


3-52 

• CSI1 

CSI Interface - part 1 

•CSI1 #CMDBUF 

MOV #CMDBUF,- (SP) 

EMT 56 


3-76 

• CSI2 

CSI Interface - part 2 

. CSI2 #CSIBLK 

MOV #CSIBLK,-(SP) 

EMT 57 


3-77 
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Global 

Mnemonic 

Function 

Macro Call 
(see notes) 

Assembly Language 
Expansion (see notes) 

Refer to Page 

• CVTDT 

Convert Binary Date or Time to 
ASCII character string 

.CVTDT #CODE,#ADDR[, VALUE] 

VALUE is an optional argu- 
ment specified with Codes 

2 and 3 only. 

If Code = 3 

MOV VALUE+2 , - ( SP ) 

If Code = 2 or 3 

MOV VALUE,- (SP) 

All codes 

MOV #ADDR,-(SP) 

MOV #CODE (SP) 

EMT 66 

3-57 

.DATE 

Obtain Date 

• DATE 

MOV #103,- (SP) 

EMT 41 

3-55 

.DELET 

Delete a File 

•DELET #LNKBLK,#FILBLK 

MOV #FILBLK,- (SP) 

MOV #LNKBLK , - ( SP ) 

EMT 21 

3-41 

•D2BIN 

Convert Decimal ASCII to Binary 

. D2BIN #ADDR 

MOV #ADDR,-(SP) 

MOV #2 , - (SP) 

EMT 42 

3-71 

.EXIT 

Exit to Monitor 

.EXIT 

EMT 60 

3-49 

. GTCIL 

Get disk address of Core Image 
library 

.GTCIL 

MOV #111,- (SP) 

EMT 41 

3-63 

. GTUIC 

Get Current UIC 

. GTUIC 

MOV #105,- (SP) 

EMT 41 

3-59 

. GTPLA 

Get Program Low Address 

. GTPLA 

CLR -(SP) 

MOV #5 , - (SP) 

EMT 41 

3-61 


GTSTK 


Get the Stack Base Address 


GTSTK 


CLR -(SP) 
MOV #4 (SP) 
EMT 41 


3-64 

















































Global 

Mnemonic 


Function 




. INIT 

Initialize a Dataset 

• KEEP 

Protect a File 

.LOOK 

Directory Search 

• MONF 

Obtain Full Monitor Size 

.MONR 

Obtain Size of Resident 

Monitor 

.OPEN 

Open a Dataset 


OPENx 


Open a Dataset 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 




. INIT #LNKBLK 

MOV #LNKBLK,-(SP) 

EMT 6 

.KEEP #LNKBLK, #FILBLK 

MOV #FILBLK , - ( SP ) 

MOV #LNKBLK , - ( SP ) 

EMT 24 

.LOOK #LNKBLK,#FILBLK[,1] 

,1 is an optional argument 

MOV #FILBLK , - ( SP ) 

MOV #LNKBLK,- (SP) 

EMT 14 

or when optional argu- 
ment is specified: 

MOV #FILBLK,-(SP) 

CLR -(SP) 

MOV #LNKBLK , — ( SP ) 

EMT 14 

.MONF 

MOV #102,- (SP) 

EMT 41 

.MONR 

MOV #101,- (SP) 

EMT 41 

.OPEN #LNKBLK, #FILBLK 

MOV #FILBLK, - (SP) 

MOV #LNKBLK , - ( SP ) 

EMT 16 

.OPENX #LNKBLK , R 

MOV #CODE , -2 (R) 

MOV R, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 16 

CODE=l for .OPENU 

2 for .OPENO 

3 for .OPENE 

4 for .OPENI 

13 for .OPENC 







































Global 

Mnemonic 


Function 


Macro Call 
(see notes) 


Assembly Language 
Expansion (see notes) 


Refer to Page 







•02BIN 

Convert Octal ASCII to Binary 

. 02BIN #ADDR 

MOV #ADDR,-(SP) 

MOV #4,-(SP) 

EMT 42 

3-73 

. RADPK 

Radix- 50 ASCII Pack 

.RADPK #ADDR 

MOV #ADDR,-(SP) 

CLR -(SP) 

EMT 42 

3-67 

.RADUP 

Radix-50 ASCII Unpack 

.RADUP #ADDR,W0RD 

MOV WORD ,- (SP) 

MOV # ADDR , - ( SP ) 

MOV #1,-(SP) 

EMT 42 

3-70 

• READ 

Read from Device 

.READ #LNKBLK , #BUFHDR 

MOV #BUFHDR,- (SP) 

MOV #LNKBLK , - ( SP ) 

EMT 4 

3-28 

. RECRD 

Read or Write a Specified 

Record in a File 

.RECRD #LNKBLK,#RECBLK 

MOV #RECBLK,- (SP) 

MOV #LNKBLK,- (SP) 

EMT 25 

3-30 

.RENAM 

Rename a File 

. RENAM #LNKBLK, #OLDNAM , #NEWNAM 

MOV #NEWNAM,- (SP) 

MOV #OLDNAM,- (SP) 

MOV #LNKBLK,- (SP) 

EMT 20 

3-42 

. RLSE 

Release a Dataset 

.RLSE #LNKBLK 

MOV #LNKBLK , - ( SP ) 

EMT 7 

3-21 

. RSTRT 

Set REstart address 

.RSTRT #ADDR 

MOV # ADDR, - (SP) 

MOV #2 , - (SP) 

EMT 41 

3-51 

.RUN 

Load a program or Overlay 

.RUN #RUNBLK 

MOV #RUNBLK, - (SP) 

EMT 65 

3-47 

• SPEC 

Special Function 

.SPEC #LNKBLK , #SPCARG 

MOV #SPCARG, - (SP) 

MOV #LNKBLK,- (SP) 

EMT 12 

3-37 














































Global 

Mnemonic 


Function 


Macro Call 
(see notes) 





.STAT 

Obtain Device Status 

•STAT #LNKBLK 

. STPLA 

Set Program Low Address 

.STPLA #ADDR 

. STFPU 

Initialize the Floating Point 
exception vector (11/45) 

.STFPU #PSW, #ADDR 

.STSTK 

Set the Stack Base Address 

. STSTK #ADDR 

. SYSDV 

Obtain System Device Name 

.SYSDV 

.TIME 

Obtain Time of Day 

.TIME 

.TRAN 

Transfer Absolute Block 

.TRAN #LNKBLK,#TRNBLK 

.TRAP 

Set TRAP Vector 

.TRAP # STATUS,# ADDR 

.WAIT 

Wait for Completion 

.WAIT #LNKBLK 

. WAITR 

Wait for Completion; Return 
to ADDR 

. WAITR #LNKBLK,#ADDR 

•WRITE 

Write on a Device 

.WRITE tLNKBLK, #BUFHDR 


Assembly Language 
Expansion (see notes) 


Refer to Page 


MOV #LNKBLK, - (SP) 

EMT 13 

3-38 

MOV # ADDR, — (SP) 

MOV #5 (SP) 

EMT 41 

3-62 

MOV #ADDR,-(SP) 

MOV #PSW,-(SP) | 

MOV #3 ,- (SP) 

EMT 41 1 

3-66 

MOV #ADDR, — (SP) 

MOV #4 , - (SP) ! 

EMT 41 ; 

3-65 

MOV #106, -(SP) 

EMT 41 

3-60 

MOV #104,- (SP) 

EMT 41 

3-56 

MOV #TRNBLK , - ( SP ) 

MOV #LNKBLK , - ( SP ) 

EMT 10 

3-33 

MOV # ADDR, - (SP) 

MOV #STATUS,- (SP) 

MOV #1,-(SP) 

EMT 41 

3-50 

MOV #LNKBLK , - ( SP ) 

EMT 1 

3-35 

MOV # ADDR, - (SP) 

MOV #LNKBLK , - ( SP ) 

EMT 0 

3-36 

MOV #BUFHDR,- (SP) 

MOV #LNKBLK,- (SP) 

EMT 2 

3-29 





















































NOTES : 


M 

I 

cn 


ADDR a memory address 

BLKBLK address of BLOCK Block 

BUFHDR address of Line Buffer Header 

CMDBUF address of Command String Buffer 

CSIBLK address of Command String Interpreter Control Block 

FILBLK address of Filename Block 

FIRST address of Filename Block of file which is to be appended to 

LNKBLK address of Link Block 

N number of 64-word segments requested 

NEWNAM address of Filename Block containing the file's new name 

OLDNAM address of Filename Block containing the file's old name 

PSW program status word for an exception routine 

R register from R0 through R5 containing address of Filename Block 

RECBLK address of RECORD Block 

SECOND address of Filename Block of file which is appended 

SP Stack Pointer (register R6) 

SPCARG code for Special Function or Address of Special Function Block as determined by Function called 

TRNBLK address of TRAN Block 



APPENDIX F 

SUMMARY OF DOS ERROR MESSAGES 


Following is a complete summary of all error messages which 
can appear when using the DOS Monitor and system programs. 

F . 1 Keyboard Command Messages 


If a command cannot be executed satisfactorily, an appropriate 
mess age w i ll be pr i nted at the te l epr i nter an d the command will be — 


xyuuieu. xxie message win oe one or one ioxiowmg 


Message 
ILL CMD! 
INV CMD! 


Meaning 

Command requested does not exist 

Command cannot be accepted at this time (e.g., 
KILL with no program to kill) 


SYN ERR! Syntax of command is faulty 


ILL DEV! 
NO FILE! 

ILL ADR! 


The device specified is illegal 

File specified does not exist or cannot be loaded 
by the RUN processor. 

Address is illegal (not on word -bound or 
in core) 


Nu CORE! Insufficient core capacity to execute command 

(SAVE) 


F. 2 Error Messages 

Error messages are printed on the teleprinter in the following 
format. 

CNNN XXXXXX 

where C is one of five letters identifying the type of message: 

I Information 

A Action required by the operator 
W Warning to the operator 
F Fatal error 
S System program error 

NNN is the message number; and XXXXXX gives appropriate additional 
information. Information , Warning , and System program messages 
are printed and the program continues. 

Action messages are printed and the program is suspended. The 
Monitor expects the operator to take some action such as "continue 
the program" (type CONTINUE), or "kill the program" (type KILL). 

Fatal error messages are printed if possible, and the program 
is suspended. The Monitor will not allow the operator to CONTINUE 
the program, but expects to see either a BEGIN, RESTART or KILL 
command. If a fatal error is a system disk failure and the error 
message cannot be printed, the central processor halts. This is the 
only time that a halt occurs in the Monitor. 


F-l 



F.2.1 Action Message 


Action messages are printed and the program is suspended. The 
Monitor expects the operator to take some action such as "continue the 
program" (type CONTINUE) , or "kill the program" (type KILL) . 


CODE/ IS SUER ADDITIONAL INFORMATION/MEANING 


A001 

DOS 

A002 

DOS 


A003 

DOS 


AJ004 

DOS 


AJ0JZI5 

OTS 


A006 

LINK 


A001 

DOS 


A010 

DOS 


User Call Address 

Disk address error. 

Device (RAD50) 

Device not ready. For example, 
the desired device/unit may be 
off-line or it may not be 
write-enabled. For DECtape or 
magtape, the proper unit may 
not have been selected. Make 
the device ready and type CO. 

Link Block Address 

The Link Block contains either 
an illegal device code or no 
device code at all. Use the 
MODIFY command to display the 
contents of Link Block+2, 
which is the dataset name 
(RAD 50) , and then use the AS- 
SIGN command to assign a de- 
vice and/or file; type CO when 
ready. 

User Call Address 

DECtape error. Try adjusting 
the tape; type CO to retry the 
operation. 

Pause Number 

A PAUSE was encountered in a 
FORTRAN program. Type CO to 
continue . 

Correct Module Name 

Paper tape loaded out of order 
on Pass 2 of Linker. Load cor- 
rect module and type CO to con- 
tinue . 

Call Address 

The name of the output file 
being created on magtape is the 
same as that of an existing file. 
Type CO to write over the old 
file or mount another tape and 
then type CO. 

0 

A parity error occurred when 
trying to open a file on magtape. 
Type CO to continue searching. 

If the file being sought has a 
parity error in its label, it 
cannot be found. 
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CODE/ISSUER 


AJ011 

DOS 


A012 


A0A3 

PIP 


AJ05J0 

BATCH 


A350 

DOS 


ADDITIONAL INFORMAT ION /MEANING 

0 = Date is Bad, 1 = Time is Bad 
System date or time is not 
valid. Re-enter date or time 
via the console keyboard and 
type CO to continue. 

Magtape error. After having 
made 15 entries on a WRITE or 
WRITE EOF, the operation is 
still unsuccessful. Type CO to 
ignore the error and proceed, or 
type KI to stop the program and 
start over with a good tape. 

Disk Pack Block Number 

This is the block that is bad; 
issued by the RP11 pack initiali- 
zer to provide a list of bad 
blocks and to permit job termi- 
nation if too many are bad. Type 
CO if number of bad blocks thus 
far is tolerable. 

0 

Batch Stream Wait. 

Type CO to continue. 


Power has come up following a 
power failure. Any I/O in 
progress has been lost, but 
information in core and in the 
registers has been retained. 

If you wish to continue, type 
CO. Note, however, that if 
I/O was in progress, the 
driver (s) may have been left 
in a state which will not per- 
mit your program to be con- 
tinued. 
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F.2.2 Information Messages 


Information 
continues . 

CODE/ISSUER 


1350 

OTS 


1351 

FORTRN 


1352 

FORTRN 


1353 

OTS 


1354 

PIP 


messages are printed and the program generally 


ADDITIONAL INFORMATION/MEANING 


STOP Number 

A STOP statement was executed 
in a FORTRAN program. 

0 

More errors of a specified type 
occurred than were allowed. 

The program is terminated. 

Address of DEVTB Entry 

The logical device specified is 
not available, (See FORTRAN 
device table, DEVTB, for a 
layout. ) 

Error Class Number 

No logging device. The command 
input device was in use when a 
run-time diagnostic message was 
to be issued. Because of a device 
conflict the normal message could 
not be issued. 


Illegal response to CONFIRM; 
when attempting to zero an 
RKll disk cartridge. The disk 
was not zeroed. Legal respon- 
ses are: 

H for high-density disks {RKfl3/fi5) 
L for low-density disk (RK02) . 
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F . 2 . 3 Warning Messages 

Warning messages are printed and the program generally continues, 
CODE/ISSUER ADDITIONAL INFORMATION/MEANING 


Wj2f02 

WJ043 


WljZfl 

RSX 


W102 

RSX 

r/r l fA o 
VV A.)U 6 

RSX 

W104 

RSX 

Wlj05 

RSX 

Wlj06 

RSX 

W107 

RSX 


W110 

RSX 


W1 1 1 

RSX 

W112 

RSX 

W113 

RSX 

W114 

RSX 

W3J0J0 

LINK 


Device Name (RAD 50) 

Device time out. 

Block Number 

-L -h ctll USIIly 

.TRAN to zero the disk. 

Number of Task Called 

Task called by number not present 
or call number illegal. Request 
ignored. 

Addr. in Call Sequence 

Delay units not correct in call 
start. Request ignored. 

Addr. in Call Sequence 

Delay time too large in call 
start. Request ignored. 

Addr. in Call Sequence 

No time slot available. Request 
ignored . 

Current Run-Time 

A level 1 task has exceeded its 
maximum run time. Task continued. 

Illegal or unrecognized console 
command. Command ignored. 

Report Number 

Illegal system report number in 
system command. Command 
ignored . 

Addr. in Call Sequence 

Attempted to start a background 
task while the background is busy. 
Request ignored. 

Addr. in Call Sequence 

Attempted to clock a background 
task. Request ignored. 


Symbolic task name not found. 
Request ignored. 


Command syntax error. Command 
ignored . 

Addr. in Call Sequence 

Illegal clock (call TRNON ) time. 
Request ignored. 

0, Module Name 

Non-unique object module detected 
in first pass. Second and sub- 
sequent occurrences of the module 
are ignored. 
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CODE/ISSUER 


ADDITIONAL INFORMATION /MEANING 


W3j2fl 

LINK 


W3J02 

LINK 


W3J33 

EDIT 


W304 

EDIT 


W3J05 

EDIT 


W3J36 

EDIT 


W3J37 

EDIT 


W310 

EDIT 


W311 

EDIT 


W312 

EDIT 


W313 

EDIT 


Addr. of Byte Error 

Byte relocation error. Linker 
automatically continues. 

0 , Symbol and Module Names 

Multiple definitions of global 
symbol. Second definition is 
ignored and linking continues. 


Buffer overflow. Overflow of 
one of the following Editor 
buffers : 

Command Input Buffer 
Save Buffer 
Page Buffer 

Macro overflow. The command 
string as stored in the Save 
Buffer was too long to execute, 
when requested to do so by an 
EM (Execute Macro) command. 

Recursive macro. The command 
string as stored in the Save 
Buffer, contains an EM command. 

Empty Save Buffer. An EM or U 
(Unsave) command was issued with 
nothing in the Save Buffer. 

Search failure. The n^h occur- 
rence of the search object was 
not found in the available test. 


Unsave failure. Insufficient 
room to copy the contents of 
the Save Buffer into the Page 
Buffer at dot. 

End-of-data detected. The end of 
the input file or the end of the 
input medium was reached during 
the last read of text into the 
Page Buffer, last page read was 
last in the file. 

Illegal line feed. A line feed 
character was encountered in the 
command string. 

Illegal negative argument. A 
negative argument was used with a 
command that does not accept 
negative arguments . 
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CODE/ISSUER 


W314 

EDIT 


W315 

ED IT —— 


W316 

EDIT 

W317 

EDIT 


W320 

EDIT 


W321 

EDIT 


W322 

LINK 


W323 

RSX 


W32 4 

RSX 


W325 

RSX 


W3 50 

RSX 

W3 52 

RSX 


ADDITIONAL INFORMAT ION /MEANING 


Arguments not permitted. The 
command specified does not 
permit any argument with it. 


Th e giv e n 
argument was not acceptable to 
the specified command. 


Illegal text string. 


Illegal command. The Editor was 
unable to execute the specified 
command. The command may be an 
illegal character, one that is 


iivju cm 


comm aim 


>»,U . 

Cuaj.au lcj. • 


Page Buffer almost full. The 
Page Buffer was within 128 
characters of being full. Write 
out part or all of the Page 
Buffer and then delete from the 
Buffer the part that was written. 

File closed. An attempt to Read 
from or Write to a primary file 
after an EF (End-of-File) command 
was issued. 


Undefined global symbols in load 
module. Linking continues. 


Illegal size of named .CSECT or 
illegal entry in named .CSECT or 
task's named .CSECT size too 
large. 


Too many entries in tasks named 
.CSECT. 


Illegal priority specification in 
real-time header. 

Number of Failures 

Powerfail interrupt occurred. 

Disk Error Code 

Disk error detected by RSX. 

Codes are: 

3 transmission error 

5 illegal error 

6 undefined file 

7 illegal file, i.e., linked 

8 block of file out of range 
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F.2.4 Fatal Messages 


Fatal error messages are printed* if possible, and the program 
is suspended. The Monitor will not allow the operator to continue the 
program, but eventually expects to see a BEGIN, RESTART or KILL com- 
mand. If a fatal error is a system disk failure and the error message 
cannot be printed, the central processor halts. This is the only time 
that a halt occurs in the Monitor. 


CODE/ISSUER ADDITIONAL INFORMATION/MEANING 


F000 

DOS 


F001 

DOS 


F002 

DOS 


F0V3 

DOS 


F004 

DOS 


F005 

DOS 


F006 

DOS 


F007 

DOS 


Request Address 

Dataset not INITed. Program 
must issue .INIT before any 
other requests to a dataset. 

Request Address 

Stack overflow. Once loaded, a 
program requires additional space 
for its stack, buffers and control 
blocks. These are allocated as 
they are needed. Reduce the size 
of the program. If the error has 
been caused by a stack overflow, 
the stack pointer is reset by 
bytes before the message is printed. 
This allows the monitor to proceed 
(since it needs the stack) and leaves 
the top of the stack intact (though 
not pointed to by SP) . (See F.2.) 

Request Address 

Invalid EMT call. The EMT code 
issued by the program has not been 
assigned . 

Request Address 

Invalid .TRAN function or .TRAN 
to an open file. 

Error Code 

Incorrect OPEN on industry com- 
patible magnetic tape. Caused 
by program error or improperly 
assigning devices via datasets. 
Defined error code values: 

0 - another file currently opened 

on tape, 

1 - attempt to READ or WRITE to 

unopened file. 

Request Address 

.RLSE error. If a file has been 
OPENed, it mush be CLOSEd before 
a .RLSE can be issued. 

Request Address 

Device full. No more space exists 
on the device being referenced by 
the request. For a file- 
structured device, use PIP to 
look at the number of free blocks 
and delete any files which are not 
needed. 

Request Address 

No buffer space available. In- 
sufficient space for completion 
of required operation. Reduce 
program size or close open files. 
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CODE/ISSUER 

F010 

DOS 


FjZfll 

DOS 


F012 


FJ014 


FJ315 

DOS 


FJ316 

DOS 


FJ017 

DOS 

F020 

DOS 


F021 

DOS 


F022 

DOS 


ADDITIONAL INFORMATION/MEANING 

Request Address 

Illegal .READ/. WRITE. Incor- 
rect mode for device or file 
not opened correctly. 

Request Address 

Illegal OPEN . OPEN code 4s not 

used or is unsuitable for device. 

Request Address 

File access violation. You are 
trying to OPEN a file that cannot 
be opened for the requested 
purpose. See Table 1 below for 
details. Assure that the name of 
the file requested was correct. 

Request Address 

F> 7 -i ovvav /-\r> -l-VTji r-» rr 

■L-' V— V j. vyj- w.lj. 1*0. jf -L. O M'wt. 

bit map. The system cannot 
proceed if it cannot read the 
bit map. New files cannot be 
created on the device nor can 
old files be extended. Existing 
files may be copied to a backup 
medium for recovery. 

Request Address 

DECtape error. Nonexistent memory 
addressed or end-zone reached 
during transfer. 

Block Number 

DECtape search failure. Block 
requested cannot be found. 

Device (RAD50) 

Parity error on file-structured 
device. 

Irrelevant 

Too many datasets using low-speed 
paper tape. A maximum of one 
each for input or output is al- 
lowed. Restart your job and use 
the ASSIGN command to reassign 
the excess datasets. 

Irrelevant 

Checksum error or device parity 
error while typing to load a pro- 
gram. Type KILL then try again. 

If that doesn't work, try re- 
linking the program. Try recreating 
the file. If the error persists, 
hardware may be faulty. Call 
field service. 

Irrelevant 

An attempt was made to load for 
execution a dataset which is not 
formated binary or which has no 
start address. Typically this 
means that the dataset being loaded 
is not a load module. 
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CQDE/ISSUER 


F023 

DOS 


F024 

DOS 


F025 

PIP 


FJ326 

DOS 


FJ027 

DOS 

FJ03J3 

OTS 


FJ031 

OTS 


F032 

DOS 

F033 

DOS 

F034 

DOS 


F035 

DCS 

Fj03 6 

RSX 

F037 


F040 

RSX 


ADDITIONAL INFORMATION/MEANING 


Program Size 

Program too large for core 
available. Try to overlay the 
program or make it smaller. 

Request Address 

File access violation. You are 
trying to perform an operation 
that violates the monitor's 
user and file protection scheme. 

See Table 1 below for details. 
Resolve access problems with owner. 

Device (RAD50) 

Master directory full when at- 
tempting to add UIC . No more 
UIC's can be added. 

Disk Control Status Register 

Disk (RF11 or RC11) transfer 
failure. Hardware error or 
persistent parity failure. 

Error Register 

Disk (RKll) transfer failure. 

Error Class, Number 

FORTRAN system error. An 
illegal call to the FORTRAN 
Error Processor was made. 

Addr. of Log Device 

No more room on FORTRAN logging 
deivce, or illegal end-of-file 
was encountered while a FORTRAN 
READ was in progress. 

Status Register 

Magtape hardware error. 

Special Function Block Address 

Invalid special function block. 

Call Address 

The call code passed to a conver- 
sion request was invalid, e.g., 

5 means binary-to-octal , but 63 
is not defined. 

Block Number 

Illegal block number (RKll) . 

Lowest Slot Used by Tasks 
No slot available. 

Lowest Slot used by Tasks 

Illegal slot specified. 

Low Address of Task Code 

Attempted to overlay the execu- 
tive for another task. 
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CODE/ IS SUER 


F041 

RSX 


F042 

DOS 

F043 

DOS 

P 04 \ 

LINK 

FjZf45 

DOS 


FJ35J0 

BATCH 


FJ051 

BATCH 


F052 

BATCH 


F053 

BATCH 


F054 

DOS 


Fj2f55 

BATCH 


F100 

RSX 


AD D I T I QNAL INFO RMA.T ION /MEAN I NG 


Load address of Binary Block 

Attempted to load outside 
limits defined in the command. 

Error Register 

Disk (RPll) transfer failure. 
Block Number 

Illegal block number (RPll) . 

$ 

Error in command string passed Py 
a Compiler via the .RUN request. 

Reguest Address 

The RUN EMT cannot find the 
requested entry in the speci- 
fied core image library. Add 
proper entry to CIL or use 
correct name. 

Request Address 

Illegal I/O to batch stream. 
Either an illegal mode (e.g., 
unformatted binary when not 
in "OWN" mode) or a byte 
count less than 83, on formatted 
read. 

Request Address 

Too many successive read errors 
or EOF's while reading the 
batch stream. 


PC 

Illegal Open to one of the 
Batch Datasets . OPENO and 
OPENI are the only legal 
OPEN'S and OPENO (OPENI) to 
an input (output) dataset 
is also illegal. 

PC 

Illegal request to the BATCH 
stream flush EMT. Request 
code mus t be 0 , 1, or 2. 

Address of DDB 

An attempt was made to load a 
new program via the RUN request 
(EMT) before releasing all of 
the datasets INITed by the 
current program. Correct the 
program by releasing all INITed 
datasets before the RUN request 
is issued. 


PC 

The time limit for the current 
job has expired. The current 
job has been aborted. 

Address in Call Sequence 

Insufficient arguments in call 
sequence or in console command. 
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CODE/ISSUER 


F240 

DOS 


F274 

DOS 


F275 

OTS 


F276 

DOS 


F277 

DOS 


F300 

FORTRN 


F301 

FORTRN 


F302 

DOS 


ADDITIONAL INFORMATION/MEANING 


Irrelevant 

An attempt was made to allocate 
a contiguous file, but not 
enough contiguous blocks are 
free . 

Irrelevant 

The stack base address has not 
properly set. Thus the stack 
could not be moved by the RUN 
EMT as requested.* This is 
probably a program error. The 
. STSTK request may be used to 
set the stack base prior to 
issuing the .RUN request. 


0 

Incorrect argument to link 
subroutine. 

Request Address 

The transfer address of the 
program or overlay to be loaded 
(by the RUN or GET commands or 
by the .RUN request) was not 
specified or is not legal. 

Specify a transfer address in 
your source program (END state- 
ment) or correct the /TR spec- 
ification in your linking pro- 
cedure . 

Request Address 

The program or overlay could not 
be loaded because it was outside 
the legal load area (on top of 
the Monitor or the main program 
or outside actual memory) . Re- 
link the program to conform to 
allowable boundries. Assure 
that the section being improperly 
loaded does not overlay the 
resident portion of your program. 

0 

FORTRAN Compiler overlays cannot 
be executed. FORTRN. OVR may be 
nonexistent or improperly con- 
structed. 

0 

No output file specified for 
the "/GO" options. 

Action Word. 

Illegal options requested in short 
form of RUN A EMT . 


F-12 



cqde/issukr 

F340 

DOS 


F342 

DOS 


F3 44 

DOS 


F346 

DOS 


F352 

DOS 


F356 

DOS 


ADDITIONAL INFORMATION/MEANING 


PC at Time of IOT 

The DOS error routine was called 
with an invalid error code. 

This might happen if the program 
branched into a data area 
since the integer 4 would be 
e xecuted as an IOT instruction - 
(the error routine is called via 
an IOT) . 

Contents of PC 

Error trap. Probably caused by a 
reference to a byte boundary or 
to nonexistent memory or to a 
nonexistent device. Could also 
be caused as a consequence of 
the stack pointer being below 
400 or by executing JMP or 
JSR with register mode destina- 
tion. 

Contents of PC 

Reserved instruction trap. The 
instruction just executed is 
not a valid PDP-11 instruction. 
Perhaps you jumped to a point 
outside your program or perhaps 
you have stored information over 
an instruction. 

Contents of PC 

Trace trap. Bit 4 of the Proc- 
essor Status Register is on. 

Look for traps in the PDP-11 
Processor Handbook. 

Contents of PC 

Trap Instruction trap. A trap 
instruction was issued by your 
program and you did not previ- 
ously specify a trap address with 
the .TRAP request. 

Contents of PC 

Unexpected device interrupt. 
Either a new device has been 
added to your system without 
initializing the interrupt vec- 
tor or a hardware failure has 
occurred . 
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Table F-l 

Recovery from F012 or F024 File Access Violations 
CONDITION ACTION 


Are you logged in? 

Is your UIC entered? 

Are you attempting to create a file 
which already exists? 

Does the Input file you are accessing 
exist? 

Are you attempting to delete a non- 
existent file? 

Are you attempting to delete a locked 
file? (The command to delete is cor- 
rect, and the file exists.) 

Are you attempting to access another 
user's file illegally? 


LOgin 

Enter it with PIP. 

Run PIP and DELETE 

Use PIP with /BR or /DI 
switch to check 

Use PIP with /BR or /DI 
switch to check 

Run PIP and UN lock 


Ask PIP to list the user's 
directory and see if an 
access error results 


F.2.5 System Program Messages 

System program messages are printed and the program continues. 
This class of error may be issued by a variety of system programs. 

If an ISSUER is specified, the error is unique to the indicated 
program. See the appropriate program manual for greater detail. 


CODE/ISSUER 


ADDITIONAL IN FORMAT ION/ME AN ING 


S001 

FORTRN 

5200 

5201 

5202 

5203 

5204 

5205 

5206 


0 

FORTRAN Compiler has exhausted 
symbol table space during the 
assembly phase of compilation. 

0 

Too many . CSECT directives. 

0 

Conditionals nested too deeply. 

Error Status Byte. Dev: file, ext. 

EOD or device error on .WRITE 
or .READ; the disk may have 
filled up. 

Relative address of error call 

Illegal switch, or too many 
switches, or illegal switch 
value, or switch value not 
given, or switch in output field. 

Relative address of error call 

Too many or too few output files. 

0 

Too many or too few input files. 

Relative address of error call 
No input files specified. 
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CODE/ISSUER 


ADDITIONAL INFORMATION/MEANING 


S2J07 

5210 

5211 

5212 

5213 

5214 

5215 

5216 

5217 

S22J0 

S223 

5225 

5226 


Error Status Byte 

EOD or device error on .TRAN. 

0 , dev: file. ext 

Unrecognized symbol table entry 
in indicated file. 

0 , dev: file. ext 

ences a global name which cannot 
be found in the symbol table. 

0 , dev: file, ext 

An RLD of the given file contains 
a location counter modification 
command which is not last. 

0 , dev: file. ext 

Object module does not start with 
ci GSD in the iridic 3. ted. file* 

0 , dev: file. ext 

The first entry in the module is 
not the module name of the indi- 
cated file. 

0 , dev: file. ext 

An RLD of the given file refer- 
ences a section name which cannot 
be found. 

0 

The TRA specification references 
a nonexistent module name. 

Relative address at error call. 
Insufficient core. 


0 

An internal jump table index is 
out of range. 

0 

No more room for CSI input buffer 
or Monitor's file manager routine, 
or Monitor's library search buf- 
fer . 

0 

Program too large or top too low 
(program has been linked below 
zero in memory) . 

0 

An open angle bracket, <, is pre- 
sent in a line other than the 
first. 
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CODE/ISSUER 


ADDITIONAL INFORMATION/MEANING 

S227 

Error Code 

Illegal file combinations due to 
name conflicts. Defined error 
codes are: 

1 No Primary File (PRI) output, 

2 Secondary File (SEC) 

input = SEC output, 

3 SEC input = PRI output, 

4 PRI input = SEC output, 

5 PRI input = SEC input, 

6 PRI output = SEC output. 

S23J0 

Error Status Byte 

Error on. BLOCK I/O. 

S231 


Illegal command, file-structured 
device required. 

S232 


No more than one action switch 
permitted . 

S233 


Specified UIC not found in MFD. 

S23 4 


Null filename of "*" given 
where filename required. 

S23 5 


No files found in UFD . 

S23 6 


Operation applicable to DEC tape 
only. 

S237 


File not found during file re- 
covery operation. 

S240 


No space for file allocate. 

S241 


MFD is full. 

S242 


Meaningless command, no action 
taken. 

S243 

0 

An open angle bracket, < , is not 

present in the first line. 

S244 

0 

Already past requested position. 

S245 

0 

Object module not found, could be 
out of order. 

S246 

0 

Illegal library format. 

S247 

0 

Listing requested, but unable to 
read output library from speci- 
fied output device. 
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CODE/ISSUER 

S25J0 

5251 

5252 

5253 

5254 

5255 

5256 

5257 


S260 

5262 

5263 

5264 

5265 


ADDITIONAL INFORMATION/MEAN ING 


Core library symbol table not 
specified first or consecutively 

No files found for "*" request. 

lowed . 

Linker error. 


It is illegal to zero the system 
resident disk. 


Match found in third of later 
binary block in a paper tape 
library . 

Illegal input device. 

File Block Error Code, dev: file. ext 
Illegal file operation. For 
example, protect code does not 
allow transfer of file? UIC dif- 
ferent from Login UIC, thus 
making certain "wildcard" opera- 
tions illegal. The operation in 
question is not performed. 


0 


0 


0 


Same device needed for input and 
output in fast copy operation 

Record size too big for buffer. 


File Number 

File record sizes do not agree 
on verify, "/V". 


0 


Conflict in standard file name 
extension which determines 
mode of transfer. Use expli- 
cits to resolve. 

Operation attempted on device 
which is not legal for non- 
privileged user, for example, 

/PK PIP switch attempted by 
a user not logged in under [1,1] 
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APPENDIX G 

LISTING OF SYSMAC.SML (SYSTEM MACRO FILE) 


t prp.TT TTCTS" ?Y«TFM FACRCS S/P.P5A 


, * a r r n , f a f a ^ 

r 0 s y a r ? 

fi 1 ■ » a p i 
fi2«7. aP2 
K 3*2 aP3 
R4*2 aP4 
R S * 2 a^5 
Rfl«* aP6 
fi 7 s2 aP7 
SP«5 AT6 
F C * 2 a <■> 7 
FS1»« Apt 77776 
SKR* AQ177S7* 

,FMry 

.MAPRO ,!N!T .L8LCK 
.MCALl. .4MPDF 
. A m r c F .LBI CK 
F M T <*CF> 

’.FNPB 

.MATRn .RISE , I Bl C* 

, W CALL , AYHDF 
.AMPCE .! BUCK 
EMJ <aC7> 

« F N P F' 

.VArRp .TLPSF .I.BLCK 
.*CAU .abode 
, ABODE .1 BUCK 
F^T <aCJ7> 

.FNTB 

.BAfRO .READ .1 BUCK ,’.L p LFF 
. P C A L • . . AMPCF 

, AMPCF . I BI FF 
.AMTOF . I buck 

E M J < a c 4 > 

• FNPM 


G-l 



.macrp 

. *a R T T F 

. LBLCK, ’.LPLFF 

>CAU 

, AMPDF 


, AMppF 

,i buff 


, ampdf 

.1 RLCK 


E^T <aC2> 


.FNTN- 



.MACRO 

.PPFNP 

.LBLCK, .FPLPK 

, M C A L 1. 

• CODE » , 

PPFN 

.rorE 

.FBLCK, 

< aP2> 

.rPFK 

.1 BLCK, 

.FBLCK 

.fnpk 



.MAffif! 

.PPFKT 

.1 BLCK, .FPLPK 

."CALL 

.POPE,, 

PPFN 

.pope 

.FRICK, 

< aP 4> 

.PPFN 

.1,0! CK, 

.FBLCK 

.fnpn 



.^APRp 

. P P F M. 

.LBLCK, ‘.FBLCK 

,*CAU. 

.POPE * « 

PPFN 

.r ore 

•FBLCK, 

< aP 1 > 

.npFK 

.1 RLCK, 

'.FBLCK 

.FNpk 



, w APRP 

.PPFKP 

,1 BLCK, .FPLPK 

, M C A I.L 

.POPE, . 

PPFN 

.pope 

.FBLCK, 

< aP 13> 

,rpFK 

.1 BLCK, 

‘.FBLCK 

.RNPK 



.MAPRP 

.P PFKF 

.1 BLCK, .FBLCK 

.MCALL 

.POPE, . 

PPFN 

.pope 

.FBI CK, 

< aP3> 

,rPFK 

.1 Bl CK, 

.FBLCK 

.FKjrp 



, M a r r r 

.PPFN 

,1 BLCK, .FPLPK 

."CALL 

.AMPDF 


. ampcf 

.FBLCK 


. AHreF 

.1 Bl CK 


F^T <ac16> 


.fntk 



, ^ ACRP 

. K A T T 

.LBLCK 

. M CALL 

.AMPDF 


, AMPDF 

.LBLCK 


EMT <AC!> 


.FNpp 



.MArfin 

.u attr 

.1 BLCK,'.APCR 

, P C A L L 

. AMODF 


.AMPDF 

. adph 


.ampdf 

, L B L C k 


E M T <AO0> 


.fnpm 



.^acpp 

. B L PC K 

,1 BL CK, .BPLPK 

.VCALL 

.AMPDF 


. amtdF 

. p e l c k 


.AMPDF 

.1 BLCK 



E V T < A c i l > 

.fnp* 
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}j a r p n 

. T R A K 

i u i r ic . ' tci r w 

• ’ v< ■ » . • W- 1 ' 

! M C A ! 1 

, A m r c f 


, A M C 0 F 

.TRI CK 


t # m r c F 

.1 PI CK 


F T < A c 1 ? > 


, F N r M 



, v a r p n 

• S P F C 

.1 PI CK, ,S.ARC 

, ^ C A 1 1. 

. AMrcF 


, A M r f* F 

.RARG 


4 AMT 0F 

.1 PI CK 

- 

. FNT F 

£ ' 


, m a r r n 

. S T A T 

.1 BUCK 

>CA|J 

, a m r n f 


, A M P 0 F 

.18! CK 


E^r <aC13> 


,F N rv 



.macro 

.AUCr 

.1 BLC*, .FPLCK, 

a M C At 1 

. Avrc-F 


„ a m r n f 

.t 


. Af 4 rc F 

.FBI CK 


. AMPCF 

.1 RICK 


E M T < a 0 1 5 » 


, F N P M 



, * AFRO 

. PFI FT 

.1 81 ck/.fplck 

e W C A L L 

, amccf 


. AMTCF 

. F p L C k 


. A VT0F 

.1 PICK 


F M T <a0?1> 


,FNPV 



.mackp 

, P Ft A M 

.1 81. CK , .CFP, ,^FB 

. wc A LI 

, AMCDF 


, a m r c f 

.FFB 


, AMfCF 

, C F 8 


. a mfpf 

.1 RLCK 


fmt < A0?e> 


, F N r V 



. w A r R ? 

. A PPM* 

,LPI CK t c P , ,PFB 

, M C AM 

. a m r 0 F 


. A M r 0 F 

, ? F B 


, A M r C F 

. 1 FR 


, a m r c F 

, 1 Bl CK 


fmt <aC? 

2> 


, F N r M 



,M AfRO 

.( OCK 

, L 8 1 CK , ‘.FPLC* , ,rp 

, M c A 1 L 

. a m r n f 


. AMT0F 

.FBI CK 


. T IF a B # 

.CP, Cl R 

-fSP) 

, a Mr 0F 

,1 P! CK 


F M T <*pu> 


, F NT M 



, v 4CRH 

. K F F P 

, L 81 C k,, F PL r< 

. M C AL.I 

. AMCDF 


. A M r 0 F 

,FBI CK 


, A Mr 0F 

.1 PI. CK 



F m T < a C ? > 
, FNP M 
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.M4CR0 .FXTT 
FUT <aC?C!> 


.FNPM 


'.MACRO 

.trap ,STLS#,ADPR 

, M CA LI. 

.AMCCF 

, amccf 

.ACCR 

AMCCF 

.ST US 

MOV 

#a 01 CSP5 

F M T <aCA 1> 

.FNPM 


.MACRO 

. S T F P (j ,STLS«,ADrR 

. m c A L L 

.amccf 

, AMOpF 

. ADCR 

. AMCCF 

• ST U S 

MOV 

#aC 3 , - (SP) 

E w T < a C 4 J > 

. CNP N 


.MACRO 

.RECRP .1 BI.CK» .RPLCK 

>CAt.l 

.AMCCF 

.amccf 

.R8I.CK 

.AMCCF 

.1 BLCK 

fMT < a Q ? 5> 

.FNPM 


.MACRO 

.PUMP .LOW, ,HTGV, ,CPF_ 

. M CAU 

. AMCDF 

. amccf 

. 1. C w 

, A M 0 C F 

.HICH 

. amccf 

.CCF 

FMT <aCF 4> 

, f n r m 


.MACRO 

.PSTRT .ADCR 

. M c A L. 1 

. AMCCF 

.amccf 

. ACCR 

MOV 

#aQ?,.(SP) 


Emt < a p 4 j. > 
,FNPM 


.macro ,roRE 

MOV *Ani 0 C,*.(SP} 

FMT < *c 4 1 > 

.FNPM 

.MACRO .MCJKR 
m 0 v # A C 1 0 1 » " C S P ) 

F^T < acA 1> 

.FNPM 

.MACRO .MCKF 

mov #ACie?»»(SPl 

E M T < a C A 1 > 

, c Nr M 


.macro .pate 

MTV #aO103,-(PP1 

F W T < aC A 1 > 

,.F npm 
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. M A r R r> , T T M F 
y n y * a 0 1 0 4 , * C s p 5 

F M T < a c 4 J > 

. FNr y 


, y a r r ft .cTiiir 

MTV *Ajj1«?F # »fSP5 

F M T < aC-4 1 > 

, FrvjP ft 


.MArcfl 

, S Y S D v 

ynv 

*api , 

F M T < a c ^ 1 > 

.FK*ry 


, ^atph 

.PATP* , AD^R 

• M C*U 

, a y r o f 

. AMfCF 

.APOR 

C! R 

• 1 5 p ) 

F v t <Af42> 

, F n r y 


. »•' A r p n 

.PAT UP , ADOC , . U RP 

. M C AL 1 

. AMFCP 

, AMrrF 

.WRP 

, a mfcf 

. A00R 

MTV 

**C 1 # * (FP 1 

F^'T <*C*2> 

.FNry 


, k * A r r n 

.r. 2 n iM ,addp 

, m C A U 

. a m r d F 

, amfff 

, APOR 

m r v 

**0?r« (SP) 

F M T < *C^2> 

, F NFM 


.mat pr 

,pjn 2 H ,ADnp f ,wpr 

, m CAL l 

, a y r n f 

, a wnnF 

.upr 

. a mt c c 

. AOOR 

y n y 

* a n T , - ( ? P ) 

FMT < aT42> 

, F NO y 


. M AFRO 

,r? RIK .ad^p 

, M C A 1, 1. 

. AMFDF 

. AMPCF 

. a on R 

y pv/ 

*aOA , - C5P) 

F^T <.*CA 2 > 

, F N r y 


,m AFR n 

.PIN2P . A D n R » , >*■ R r 

.MCH! 

. AMPDF 

, AMPCF 

. U RT 

, a m r r f 

, AnnR 

yry 

*aCF#- CPP) 


F*T <*C^?> 

.FNry 


G-5 



, A f R P .rsrj .fMPPF 
,MC«U , A MfiQF 
. A M P C F . P M P P F 
F M T < * r K 6 > 

, c m r y 

,^aprp , r s t 2 ,CSWIK 
,mca i i . a v r D f 

. A m p p F .PSPL* 

E m T <aC k 7> 

. p m r m 

, m a r r i* 1 
.“CALL 
, r V T p T 
. F M p y 

, ^ APRP .TMPVT ,ADPR 
.“CAUL .CVTDT 
, P V T p T *AC1f’.APDR 
.FNPM 

.MACRP .CVTDT .PDF , . APDF f ,VAt_1 /.VAL2 

.MCAI.I. .AMPOF 

,TF NP/.V AL2 

.AMrpF . V A L 2 

.FNiPC 

,TF NP..VAL1 

, a m r n f . v a i l 
, fmpc 

,a“CCF , a pr r 
. A m r £ F .CDF 
FMT < *C^6> 

, F KJ r M 

. ^ a r r n , n T p L a 
C l P *fS P) 

MTV * a C 5 # - ( !S P ) 

F M T <aC^1> 

.FNPM 

, m A P R P .STPLA , A D r ' R 
.MCA L I. .AVCCF 
. A M r > p F , AQPR 
y p V *Af!S* (fp} 

E m T <AC^1> 

, Fnpm 

, v at r p .PTC II 

ynv MnUI»-(SP5 

E M T <aC^1> 

, f n r y 

, y a r R n . r t S T k 
Ci R -fSP) 
ynv * * o A , • ( s P ) 

e m t < a r a i > 

,FNry 

.MAPfiP . S T 5 T K , A DPR 
, M C A L I .AMPDF 
.AHrpF ,/DDR 


, r TC V t . A DPR 
.PVTDT 
#ApP,'. apdp 
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MTV * a n 4 , * ( S P 1 

E m t < a r ^ i > 

. F N P M 


, »' A r R ft , P U M , P M R l K 

, ** c 4 l i. . a v r n f 

. fivrcF , p k p l «• 
h M T < * C E g > 

p K j p y 

.hated .FLLSH t rDF 
, MCAI.I , A H T OF 
« a y! r C F .OOF 
E‘ 4 T < * D * 7> 

,FMPM 

! T F E MACFO .AMOOF ACCEPT? D\F A R G L H E N T AMD 
; AS A FIjMCTIDK OF THE AOPRF,«pUG MOF of 
? THE ARRWMFM GENERATES THE APPROPRIATE 

) H “ v TP • ( 5 P ‘ , 

; a r o R E ? s mcdfs teat arf trclplescyf fE.r,'. 

> X f s p ) 5 OR l K L T K F t V f F , G , SR 5 ’* ILL RESULT 
; If' a ,E p RrR to ryn INCLUDING thf 
i VAIJ F C p thf ADDRESS voo-E £F.g § *fS p l 
t IP R E p RF SF ME D AS 0PBP6F)» THF AfiPL M ENT ITSELF 
I AND TF’f TFXT "ADDRESSING II LFGAL A c SYSTFm 

f N A C R C A P G > y F NT " , 
t 

, m a r r r . a h r d f , a r g 

S p = » a r f 

, M v P F .SYNr.ARG * , S YM« ADOPFSS 

.IF l, F,,SVM-Mg 

vrv , ARG,. (SP) *R? TO Rg 

, M FYIT 

.RNGC 

,TF FO, ,SVM*Ar7P*A0!7 
,TF LF,' # SYY*Ar7-Ap6 

ypv .ARf, f «(SP) i*Rf t n #pg 

.‘'EY IT 
, FMPT 

, f \ r c 

, T F FD,,SYMRAr6PwA0?5’ 

W r“ V .ARG#«£SP5 

, U E V T T 

, f n r c 

.IE FP,.SYNKArd!?-AG40 
. t F L p * .SYM*AP7-An5 
y D V . 4 R G , - ( S P ) I T * ] * f R (”> ) Tr r • J - f R « ) 

, y E y I T MFlXfRBJTrrRlyCR*) 

• F N P C 
. F N 0 C 

.IF Ffl».SYMHAr67-AQ«7 

ypv . A R G , - ( S P 3 jADDR AMD * A 0 n R 

. y f y i t 
, c N P C 


f f # 1 £ R <5 1 ♦ TP f * 1 f E 7 3 ♦ 
i *N , ADDR 
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.FRGCP ,SYN i’.AFG ADDRESSING WDDF I L L F G A L 

.PRINT JA$ S Y S T E u MADRD ARGUMENT*, 

.fndm 

I TF E YACFn , rcDE SETS UP THE FTLEBI CCK 
l KTTH T|hF HCW rPFK C D D F 
t THF ADDRESS CF THF Fit ERIDCK m UST 
I EF T N A REGISTER fRP TO RF) 


.HADRO , f D D F. ,FR|.K f| M 
, N T Y P F ,SYH, ,FPLK 

, TF L F , ,SYM»Arg 

Mnyp *.N,-aO?c'.FP{.K) »R(2 TC R« 

, V E Y I T 
t F N D r 

,FRDC D '.SYM I.FFLK ADDRESSING MftfF TLi FpAL 

.print »fcr n p f n pile pt.nrK 

. F ND N 
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APPENDIX H 

PERIPHERAL DEVICES 


H.l OPERATING THE TELETYPE 


the 


PDP-11 



computers. It consists of a printer, keyboard, paper tape reader, 
and paper tape punch, all of which can be used either on-line under 
program control or off-line. The Teletype controls (Figure H-l) 
are described as they apply to the operation of the computer. 


OFF 

REL. 

B. SP- 
ON 

START - 
STOP - 
FREE - 


OFF 

LINE Q LOCAL 

Figure H-l ASR-33 Teletype Console 


H.1.1 Power Controls 


LINE 


OFF 

LOCAL 


The Teletype is energized and connected to the 
computer as an input/output device, under 
computer control. 

The Teletype is de-energized. 

The Teletype is energized for off-line opera- 
tion. 


H.l. 2 Printer 


The printer provides a typed copy of input and output at 10 
characters per second, maximum. 
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H.1.3 Keyboard 


The Teletype keyboard is similar to a typewriter keyboard. 
However, certain operational functions are shown on the upper part 
of some of the keytops. These functions are activated by holding 
down the CTRL key while depressing the desired key. For example, 
when using the Text Editor, CTRL/U causes the current line of text 
to be ignored . 

Although the left and right square brackets are not visible on 
the keyboard keytops, they are shown in Figure H-2 and are generated 
by typing SHIFT/K and SHIFT/M, respectively. The ALT MODE key is 
identified as ESC (ESCape) on some keyboards. 
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Figure H-2 ASR-33 Teletype Keyboard 
H.1.4. Paper Tape Reader 


The paper tape reader is used to read data punched on eight- 
channel perforated paper tape at a rate of 10 characters per sec- 
ond, maximum. The reader controls are shown in Figure H-l and 
described below. 

START Activates the reader; reader sprocket wheel 

is engaged and operative. 

STOP Deactivates the reader; reader sprocket wheel 

is engaged but not operative. 

FREE Deactivates the reader; reader sprocket wheel 

is disengaged. 
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The following procedure describes how to properly position 
paper tape in the low-speed reader. 

a. Raise the tape retainer cover. 

b. Set reader control to FREE. 

c . Posi tion the leader porti on of the ta p e over the read 
pens wita me sprocxer v r s£G > ncj.es over me sprocxec 
(feed) wheel and with the arrow on the tape (printed 
or cut) pointing outward. 

d. Close the tape retainer cover. 

e. Make sure that the tape moves freely. 

f. Set reader control to START, and the tape will be read. 
H.1.5 Paper Tape Punch 

The paper tape punch is used to perforate eight-channel 
rolled oiled paper tape at a maximum rate of 10 characters per 
second. The punch controls are shown in Figure H-l and described 
below, 

RELease Disengages the tape to allow tape 

removal or loading. 

B.SP Backspaces the tape one space for each 

firm depression of the B.SP button. 

ON (LOCK ON) Activates the punch. 

OFF (UNLOCK) Deactivates the punch. 

Blank leader/trailer tape is generated by: 

1. Turning the TTY switch to LOCAL 

2. Turning the low speed punch on (depress ON button) 

3. Typing the HERE IS key 

4. Turning the low speed punch off (depress OFF button) 

5. Turning the TTY switch to LINE. 

H . 2 OPERATING THE HIGH-SPEED PAPER TAPE READER AND PUNCH UNITS 

A high-speed paper tape reader and punch unit is pictured in 
Figure H-3 and descriptions of the reader and punch units follow. 
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H . 2 . 1 Reader Unit 


The high-speed paper tape reader is used to read data from 
eight-channel fan-folded (non-oiled) perforated paper tape photo- 
electrically at a maximum rate of 300 characters per second. 
Primary power is applied to the reader when the computer POWER 
switch is turned on. The reader is under program control. How- 
ever , tape can be advanced past the photoelectric sensors without 
causing input by pressing the reader FEED button. 

H.2.2 Punch Unit 


The high-speed paper tape punch is used to record computer 
output on eight-channel fan-folded paper tape at a maximum rate of 
50 characters per second. All characters are punched under program 
control from the computer. Blank tape (feed holes only, no data) 
may be produced by pressing the FEED button. Primary power is 
available to the punch when the computer POWER switch is turned on. 



FEED 

ON LINE 
FEED 


Figure H-3 High-Speed Paper Tape Reader/Punch 


Paper tape is loaded into the reader as explained below. 


1. Raise tape retainer cover. 

2 . Put tape into right-hand bin with channel one of the 
tape toward the rear of the bin. 

3. Place several folds of blank tape through the reader 
and into the left-hand bin. 





4 . 


Place the tape over the reader head with feed holes 
engaged in the teeth of the sprocket wheel. 

5. Close the tape retainer cover. 

6. Depress the tape feed button until the leader tape is 
over the reader head. 


CAUTION 

Oiled paper tape should not be used in 
the high-speed reader or punch - oil 
collects dust and dirt which can cause 
reader or punch errors . 


H. 3 THE LP11 LINE PRINTER 

The LPll is a line printer with 80 column capacity,- capable of 
printing more than 300 lines per minute at a full 80 columns, and 
more than 1100 lines per minute at 20 columns. The print rate is 
dependent upon the data and the number of columns to be printed. 

Characters are loaded into the printer memory via the Line 
Printer Buffer (LPB) serially. When the memory becomes full (20 
characters) the characters are automatically printed. This 
continues until the 80 columns have been printed or a carriage 
return, line feed, or form feed character is recognized. 

H.3.1 Printer Control Panel 


Figure H-4 illustrates the printer control panel on which are 
mounted three indicator lights and three toggle switches. 
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Figure H-4 Line Printer Control Panel 
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Operation of the lights and switches is as follows: 


POWER light 


READY light 


ON LINE light 


TOP OF FORM switch 


PAPER STEP switch 


ON LINE/OFF LINE switch 


Glows red to indicate main power 
switch (located inside cabinet) is 
at ON position and power is available 
to the printer. 

Glows white, shortly after the POWER 
light goes on to indicate that in- 
ternal components have reached 
synchronous state and the printer 
is ready to operate. 

Glows white to indicate that ON LINE/ 
OFF LINE toggle switch is in ON LINE 
position. 

This switch is tipped toward the 
front of the cabinet to roll up the 
form to the top of the succeeding 
page. It is spring-returned to 
center position, and produces a 
single top-of-form operation each 
time it is actuated. The switch 
is effective only when the printer 
is off line. 

Operates similarly to TOP OF FORM 
but produces a single line step 
each time it is actuated. It is 
only effective with printer off line. 

This two-position toggle switch is 
spring-returned to center. When 
momentarily positioned at ON LINE 
it logically connects the printer 
to the computer and causes the ON 
LINE light to glow. Positioned 
momentarily at OFF. LINE, the logical 
connection to the computer is broken, 
the ON LINE light goes off, and the 
TOP OF FORM and PAPER STEP switches 
are enabled. 


H.3.2 Maintenance Panel 

The maintenance panel contains controls used for the line 
printer's initial set-up and maintenance. It is accessible only 
by opening the front cabinet door, located beneath the control panel. 

This panel contains three switches, and three indicators. 

1. Main AC power switch; 

2. PRINT INHIBIT switch - must be off (down) to enable printing? 
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3. DRUM GATE indicator - if lit, drum gate not properly 
locked; 

4. PAPER FAULT - if lit, check for no paper, or torn paper; 

5. PRINT INHIBIT indicator - if lit, turn PRINT INHIBIT 
switch off; 

6 . MASTER CLEAR switch - spring-loaded to off (down) ; if 

togg l e d to on — (up), re s et s pr i nter log ic , turn s off 

READY and ONLINE indicators. 


H.3,3 Adjustment Controls 


Controls are provided as listed in Table H-l. 


Table H-l Adjustment Controls 


Control 

Location 

Function 

Drum gate latch 

Gearshift type knob near 
right-hand side of main- 
tenance panel . 

Unlocks drum gate 
which can then be 
swung open for access 
to components on back. 

Tractor paper width 
adjustment 

Setscrew at far right of 
tractor pressure plate 
behind drum gate. 

Adjusts right tractor 
for various paper 
widths; left tractor 
is factory adjusted. 

Tractor horizontal 
tension adjustment 

Next to left side of 
tractor paper width 
adjustment. 

Adjusts horizontal 
tension of paper. 

COPIES CONTROL lever 

Extreme upper right-hand 
corner of cabinet just 
above drum gate hinge. 

Adjusts the distance 
between hammer bank 
and character drum 
for different numbers 
of printed copies. 
Settings are: 1-2, 

3-4 and 5-6. 

Paper vertical ad- 
justment control 

Knob at upper left of 
cabinet, directly above 
right-hand side of 
maintenance panel 

Adjusts vertical 
alignment of printing 
so that it prints on 
lined paper. Can be 
adjusted to plus or 
minus one line and 
may be adjusted while 
the printer is in 
operation . 

Top-of-form in- 
dicators 

Red arrows visible when 
drum gate is swung open 
one on each side of 
paper directly below 
tractor pressure plates 

Aligns paper during 
loading . 






H.3.4 Loading Paper 


Follow the steps listed below to load paper into the printer. 


Step Procedure 

1. Open front door of cabinet to gain access to maintenance 
panel and turn main AC power switch on. Verify that con- 
trol panel POWER indicator lights . 

2. Lift control panel TOP OF FORM switch and release to move 
tractors to correct loading position. 

3. Open the drum gate by moving the drum gate latch knob to the 
left and up. Swing drum gate open. 

4. Adjust right-hand tractor paper width adjustment for proper 
paper width. This is accomplished by loosening the set 
screw on the 80-column model or by using the easy release 
mechanism on the 120 column model. Make certain that the 
right-hand tractor is tightened in place after it is 
adjusted. 

5. Open spring-loaded pressure plates on both tractors. 

6 . Load paper so that a perforation is pointed to by the two 
red arrows (top-of-form indicators) . Paper should lie 
smoothly between tractors without wrinkling or tearing the 
feed holes. 

7. Close spring-loaded pressure plates on both tractors, 

8 . Adjust the COPIES CONTROL lever to the proper number for 
the number of copies to be made. For example, set to 1-2 
for single forms, set to 5-6 for six-part forms. 

9. Close drum gate and lock into position with drum gate 
latch. After approximately 10 seconds the control panel 
READY indicator should light. If it does not, check to see 
if any error is indicated. An error is indicated if one of 
the following lights is on: DRUM GATE, PAPER FAULT, or 
PRINT INHIBIT. 

10. Lift TOP OF FORM switch several times to ensure paper is 
feeding properly. 

11. Set system to on-line mode by lifting ON LINE/OFF LINE 
switch and verifying that ON LINE indicator lights. At 
this point, printed matter can be aligned with the paper 
lines by rotating the paper vertical adjustment knob. 


For further details on the LP11, refer to the LP11 Line Printer 
Manual, DEC-ll-ODLPA-A-D . 
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H.4 THE TU10 MAGTAPE DRIVE 


The TU10 is a magnetic tape drive which may be a 7- or 9-track 
unit and which will record data in densities of 200, 556 or 800 bits 
per inch. 

Figure H-5 shows the magnetic tape drive control panel and its 
schematic repres entation. T a ble H-2 shows the meaning as sig ned to 
each indicator light and Table H-3 explains the function of each switch. 



CP -0093 


PW H OH 

ON LINt 

SJ'ARI 

OF F 

LOAD 

OFF LINE 

Stop 

FWD 

i 

i 

i 

i 

i 

0 

t 

i 

1 

REW 

BR REL 

UNIT 

SELECT 

REV 



- 


Figure H-5 Magnetic Tape Drive Control Panel 





Table H-2 
Status Indicators 


Indicator 

Procedure 

PWR 

Indicates that power is being supplied to the drive unit. 

OFF-LINE 

Indicates local operation by the control box. 

LOAD 

Indicates that the vacuum system has been enabled and 

the unit is prepared to accept on-line or off-line commands. 

SEL 

Indicates the tape transport has been selected by the con- 
troller (program) . 

RDY 

Indicates that the drive is ready to accept requests for 
operation (provided the SEL light is also lit) . 

WRT 

Indicates that the program has initiated a write opera- 
tion in the tape transport. 

LD PT 

Indicates that the tape mounted on this unit is at its 

Load point (BOT marker is being sensed) . REW command is 
disabled. 

FWD 

Indicates that a forward command has been issued. 

END PT 

Indicates that the tape mounted on this unit is at its 
end point (EOT marker is being sensed). FWD command is 
disabled. 

REV 

Indicates that a reverse command has been issued. 

FILE PROT 

Indicates that the tape may not be written on (No Write 
ring in tape reel). 

REW 

Indicates that a rewind command has been issued. 


Table H-3 
Switch Functions 


Switch 

Function 

PWR ON/OFF 

Controls power to the drive. 

ONLINE/OFFLINE 

Transfers drive control to processor 
(ON LINE) or enables local control box 
control by operator (OFF LINE) . 

START/STOP 

Initiates or terminates tape movement. 

LOAD/BR REL 

LOAD position causes tape to be drawn 
into vacuum columns. 

Center position applies reel motion 
brakes . 

BR REL position releases reel motion 
brakes . 

UNIT SELECT 

Assigns a logical unit number (zero 
through seven) to this drive. 

FWD/REW/REV 

Selects tape motion direction to be con- 
trolled by START/STOP switch. FWD posi- 
tion indicates transfer to take-up reel 
until EOT (end of tape) marker is sensed, 

REV position indicates transfer to file 
reel until BOT (beginning of tape) marker 
is sensed, REW position indicates transfer 
as in REV at a higher tape speed; when the 
tape stops at BOT, depressing the start 
switch again causes tape to unload. 
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Operating Procedures 


H.4.1.1 Loading and Threading Tape - Use the following procedure to 
mount and thread the tape: 


Step Procedure 

1 Apply power to the transport by depressing PWR ON 

2 Ensure the LOAD/BR REL switch is in the center position 
(this applies the brakes) . 

3 Place a write enable ring in the groove on the file 
reel if data is to be written on the tape. 

Ensure there is no ring in the groove if data on the 
tape is not to be erased or written over. 

4 Mount the file reel onto the lower hub with the groove 
facing towards the back. Ensure that the reel is 
firmly seated against the flange of the hub. 

5 Install the take-up reel (top) as described in Step 4. 

6 Place LOAD/BR REL switch to the BR REL position. 

7 Unwind tape from the file reel and thread the tape 
over the tape guides and head assembly as shown in 
Figure H-6. 

8 Wind about five turns of tape onto the take-up reel. 

9 Set the LOAD/BR REL switch to the LOAD position to 

draw tape into the vacuum columns . 

10 Select FWD and press START to advance the tape to 

Load Point. When the BOT marker is sensed, tape 
motion stops, the FWD indicator goes out, and the 
LOAD PT indicator comes on. 

NOTE 


If tape motion continues for more than 10 seconds, 
press STOP, select REV (reverse) and press START. 
The tape should move to the BOT marker (Load Point) 
before stopping. 
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H.4.1.2 Unloading Tape - To unload the tape proceed as follows: 


Procedure 


1 Press OFF-LINE switch if the transport has been 
operating in the on-line mode. 

2 Press STOP switch and select REW. 

3 Press START switch. The tape should rewind until 
the BOT marker is reached. 

4 Press the LOAD/BR REL switch to release the brakes. 

5 Gently hand wind the file reel in a counterclockwise 
direction until all of the tape is wound onto the 
reel . 


CAUTION 

When handwinding the tape, do not jerk the reel. 
This can stretch or compress the tape which could 
cause irreparable damage. 

6 Remove the file reel from the hub assembly. 



Figure H-6 Tape Transport Mechanism 
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H , 4 . 1 » 3 Restart After Power Failure - In the event of a power 
failure, the DECmagtape automatically shuts down and tape motion 
stops without damage to the tape. Return of power is indicated when 
the PWR indicator lights. To restart the transport proceed as 
follows : 

Stem Procedure 

1 Press the LOAD/BR REL switch to release the brakes. 

2 Manually wind the reels to take up any slack in the 
tape . 

3 Set the LOAD/BR REL switch to the LOAD position to 
draw tape into the vacuum columns. 

4 Set ON-LINE/OFF-LINE switch to the desired position 
and continue operation. 

H.4.1.4 Restart After Fail-Safe - If the tape loop in either buffer 
column exceeds the limits shown in Figure H-6 , the vacuum system 
automatically shuts down and tape motion stops without damage to the 
tape. When this fail-safe condition occurs, the DECmagtape does not 
respond to on-line or off-line commands. To restart the transport, 
perform Steps 1 through 4 in Paragraph H.4.1.3. 

H.4.1.5 - Tape Handling - Observe the following precautions when 
handling magnetic tape: 


a. Always handle a tape reel by the hub hole; squeezing the 
reel flanges can cause damage to the tape edges when winding 
or unwinding tape. 

b. Never touch the portion of tape between the BOT and EOT 
markers. Oils from fingers attract dust and dirt. Do not 
allow the end of the tape to drag on the floor. 

c. Never use a contaminated reel of tape. This spreads dirt to 
clean tape reels and can affect tape transport operation. 

d. Always store tape reels inside their containers. Keep 
empty containers closed so dust and dirt cannot get inside. 

e. Inspect tapes, reels, and containers for dust and dirt. 
Replace take-up reels that are old or damaged. 

f. Do not smoke near the transport or tape storage area. 

Tobacco smoke and ash are especially damaging to tape. 

g. Do not place the DECmagtape near a line printer or other 
device that produces paper dust. 

h. Clean the tape path frequently as described in Paragraph 

5.2.1. 
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H. 5 THE TCll DECTAPE DRIVE 


Figure H-7 pictures the TCll DECtape drive unit. Table H-4 
shows the meaning of each indicator lamp and Table H-5 shows the 
function of each switch. 



Figure H-7 TCll DECtape Drive 


To mount a DECtape on the TCll: 


1. Move the LOCAL/REMOTE/OFF switch to the OFF position. 

2. Mount a DECtape by centering it over the left band hub 
and pushing it firmly onto the spring loaded hub. 

3. Wind sufficient tape to wrap around the recording head 
guides and the empty DECtape reel which should be mounted 
on the right hand hub . 

4. Take up a few inches to tape on the right hand hub by hand. 

5. Move the LOCAL/REMOTE/OFF switch to LOCAL position. 

6. Depress the DECtape motion switch to the LOAD position 
until about 6 feet of tape are on the right hand hub. 
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7 . Depress the WRITE PROTECT switch or write enable as 
appropriate . 

8. Assure that the unit number showing for this drive does 
not show on any other drive . 

9. Move the LOCAL/OFF /REMOTE switch to the remote position. 


To dismount a DECtape from the TC11: 

1. Move the LOCAL/OFF /REMOTE switch to the LOCAL position. 

2. Depress the tape motion switch in the rewind direction («-) 
until all the tape is on the left hand reel. 

3. Move LOCAL/OFF/REMOTE switch to OFF position. 

4. Pull the DECtape reel from the left hand hub. 
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APPENDIX I 
COMMAND STRING INTERPRETER 

rC • ~7.S *£ 

1.1 SYSTEM PROGRAM/USER PROGRAM COMMAND STRINGS R % - H C. 

There is a single, general format for all system program 
command strings. All system programs use it, and any user program 
may also do so. These command strings are all processed by a 
Monitor routine, the Command String Interpreter (CSI) which is in 
Section 3.8.6. Any program expecting such a command first types 
# on the console to indicate the fact to the operator. The general 
format is 


ds ~ spec C [ds-spec] ... 


li 1 ' 


J * 


• • 


1 

.o 


_J j 


where "ds-spec" represents a dataset specifier (described in the 
next section), brackets indicate optional items, and elipsis (...) 
indicates that the preceding item may appear zero or more times. 
Items preceding the < (if any) describe output datasets; those 
which follow describe input datasets. 


1.2 CSI COMMAND FORMAT 


Whenever a system program requests input through the CSI, a 
# will be printed on the teleprinter (exception, 0DT-11R prints an 
*) and the program will wait for the operator's reply. A CSI command 
may consist of one or more output dataset specifications, followed 
by <, followed by one or more input dataset specifications. 

Spaces, horizontal TABs , and nulls may appear anywhere in the 
string and are ignored. A command is terminated by typing the 
RETURN key, which causes both carriage return and line feed char- 
acters to be passed to the program. The line-feed character 
terminates the input. < need not occur. If it does, at least one 
input file specification must appear. Only one < per command is 
allowed. Commands can not be continued from line to line. 

A dataset specification must be delimited by a comma. If no 
items appear before the comma, it is interpreted as "this particular 
positional field will not be used". For example, suppose a program 
requires three (output) data specifications. Then the syntax: 
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Dataset Specif ication , , Dataset Specification 


indicates that the second (output) dataset specified will not be 
generated . 


Each dataset specification is a field which describes a data- 
set. It generally contains information as to where to find the 
dataset, the file name and extension if the dataset is a file, the 
user identification code associated with the file, and one or more 
switches which request various actions to be performed. A dataset 
specification containing all of the above elements would appear as: 


devrfilnam.exttuicl/sw^tv^: . . . :v n /sw 2 :v^: • • • :v n , 

where: dev = The device specification consisting of two or three 
letters (and often an octal digit) terminated by a 
colon. The letters identify the device and the digit 
identifies the unit. Units must be given in octal. 

The colon delimits this field with one exception; 
only physical names as listed in Appendix A may be 
specified. For example, DTA1 : is the correct speci- 
fication for DECtape, controller A, unit 1. The 
exception is SY: which is a generic name for the 
system residence device (e.g., on an RK system SY: 
is equivalent to DK:). If no digit appears, unit 0 
is assumed. If the device specification itself does 
not appear, the device is assumed to be the device 
last specified, on the current side of the <, if 
there is one; otherwise, the system disk (SY:) unit 0 
is assumed. 

Assumptions (defaults) do not carry across the <, i.e., 
from output to input. 

filnam = The file name specification consists of one or more 
letters or digits, or exactly one asterisk. The 
first six letters or digits specify the name. The 
first character must be a letter. All letters and 
digits in excess of six are ignored. 

The file name need not appear if the device is not 
file-structured or if the program can supply a name. 

.ext = The extension specification consists of a period, 

followed by one or more letters or digits, or followed 
by exactly one asterisk. The first three letters or 
digits specify the extension. All letters or digits 
in excess of three are ignored. 

The extension need not appear. 

The asterisk is used to specify "all". For example: 

* . EXT specifies all files with extension .EXT, 
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FIL.* specifies all files with name FIL, and 
*.* specifies all files and all extensions. 


[uic] = The User Identification Code (UIC) specification 

consists of a left square bracket, followed by one or 
more octal digits or exactly one asterisk, followed 
by a comma, followed by one or more octal digits or 
exactly one asterisk, followed by a right square 
bracket . The field to the left of the comma specifies 
the user's group and the field to the right of the 
comma specifies the user within the group. Both 
fields must be given in octal, and the largest valid 
octal number is 376 in both cases (0 is invalid) . 

For example, [12,136] is the correct specification 
for user number 136 of user group 12. 


NOTE 

r PVi a 1 oft- an/3 v -i rfV-i +- ermaT*o hrar>Vaf c ara r>/~v+- 

visible on some keyboard keys; however, they 
may be typed using SHIFT/K and SHIFT/M, 
respectively . 

As in filnam and .ext, the asterisk specifies "all”. 

For example: 

[*,136] specifies all users whose number is 136 
[12,*] specifies all members of user group 12 , and 
[*,*] specifies all users. 

The user identification code need not appear, in which 
case the default is the identification entered with 
the LOGIN command. 

/sw:v, :...:v = A switch specification consists of a slash (/) , 
n followed by one or more letters or digits, and 

optionally followed by one or more value specifica- 
tions. A value specification is initially delimited 
by a colon. The value itself can be null, or consist 
of one or more letters , digits , periods , or dollar 
signs. Other characters are illegal. The digits 8 
and 9 are legal. 

For examples: /DATE: 12 .20 .69 might be a switch to 
enter December 20, 1969 in a date field. 

/DATE:12::69 might enter December, 1969 in a date 
field. 

Switches need not appear. If a switch does appear, 
it need not contain more than one letter or digit 
after the slash. For example: 

/S and /SWITCH2 are both legal. 

The first two characters after the slash uniquely 
identify the switch. For example: 

/S is treated as if it were /S null. 

/SWITCH1 and /SWITCH2 are both treated as /SW. 

Table 1-1 summarizes the legal command syntax. 


1-3 



Table 1-1 


.CSI Command String Syntax Rules 


Item Which 

Last Appeared 

t 

DEV: 

Item Immediately Following 

FILNAM .EXT UIC /SWITCH 

< Terminator * 

blank 1 

* 

* 

* 

E 

* 

* 

* 

* 

* 

r 

* 

* 

* 

E 

* 

* 

* 

* 

★ 

DEV: 

* 

E 

* 

E 

* 

* 

* 

* 

* 

FILNAM 

* 

E 

E 

* 

* 

* 

* 

* 

E 2 

.EXT 

* 

E 

E 

E 

* 

* 

* 

* 

E 

UIC 

* 

E 

E 

E 

E 

* 

* 

* 

E 

/SWITCH 

* 

E 

E 

E 

E 

* 

* 

* 

E 

< 

* 

* 

* 

E 

* 

* 

E 

E 

* 


Legend: E indicates error. * indicates legal. 

x The next item encountered is the first item in the command string. 
2 .* is legal following FILNAM. 


For example, a device specification immediately followed by an exten- 
sion specification is an error, whereas a file name specification 
immediately followed by a comma is legal. Note that a /SWITCH 
specification is always legal even alone. In such a case, the system 
device SY: and a null filename are assumed. 


1.3 CSI COMMAND EXAMPLE 


An example of a complete command is: 


F1.E1, ,DTA1:F2.E2/S:1<F3.E3 [11,123] ,DTB:F4 .E4/ABC ,F5 ,E5 


which is interpreted as explained below. 


a. The first positional output dataset is to be a file named 

FI and will have extension El. It is to be put on disk unit 0, 
and catalogued under the ID of the user who entered the command. 
No switches are associated with this dataset. 

b. The second positional output dataset will not be generated. 

c. The third positional output dataset is to be in a file named 
F2 and will have extension E2 . It is to be put on the 
DECtape which is mounted on unit 1 of controller A. This 
file is to be catalogued under the ID of the user who entered 
the command. The action indicated by switch S with value 1 is 
to be performed on this dataset. 
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d. The fourth and subsequent positional output dataset will not 
be generated. 

e. The first positional input dataset is a file named F3, and 
its extension is E3. It can be found on disk unit 0, cata- 
logued under the user number 123 of user group 11. No 
switches are associated with this dataset. 


f . The second positional i npu t d a t a s e t is a f i 1 & ri am pr! F4 . and 

its extension is E4 . It can be found on the DECtape currently 
mounted on controller B, unit 0. Associate the ID of the user 
who entered the command with this dataset. Perform the action 
indicated by switch AB ( not ABC) on this dataset. No values 
are associated with tKe switch. 


g. The third positional input dataset is a file named F5 and its 
extension is E5. It can be found on the DECtape currently 
mounted on controller B , unit 0. Associate the ID of the 
user who entered the command with this dataset. No switches 
are associated with this dataset. 

h. The fourth and subsequent input datasets are not required. 
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APPENDIX J 

SPECIAL I/O FUNCTIONS 

Certain I/O functions are sufficiently device-dependent that they 
are beyond the scope of the File System. The .SPEC request (see 
Section 3.6.12) is provided as a means of accommodating such functions. 

A o p-i o 1 -pi-j y-j /-i 4- *i r — - 5 , T l_ J — V. c! 4= V,,- ^ J Li- 

** * J L- -1- -L J_ W xlw CS.JL. y f Yv'IiJLsJIi S ILIiOi. 

a code in the range 0-255 or a pointer to a special function block. 
When a special function block is used, it must contain a code. 


In general, special function codes will have similar meanings 
from device to device. When a code has no meaning for a device, it 
is treated as a no-op. Currently, special functions are defined 

IQ! may tape • 

J. 1 MAGTAPE FUNCTIONS 


J.1.1 Special Function Block 


The magtape driver requires a special function block to perform 
the special function requests. The following is the calling sequence 
for magtape special functions and the special function block format: 


SPEC #LNKBLK, #SFBLK 


SFBLK: 


BYTE Special function code 

BYTE Words to follow (must be 3 or larger) 

WORD Tape unit status (returned by driver) 

WORD User specified count or control information 
WORD Residue count (returned by driver) 


J.1.2 Functions 


Code 


Function 


1 Offline (rewind and unload) 

2 Write End-of-File 

3 Rewind 

4 Skip Record (s) 

5 Backspace Record (s) 

6 Set Density and Parity 

7 Obtain Status 
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J. 1.2.1 OFFLINE (Rewind and Unload) - function Code 1 


This request causes the magtape to be rewound to the beginning- 
of-tape (BOT) marker and SELECT REMOTE status to go off. If the 
last command to the driver for this device was a WRITE, three EOF's 
are written before rewinding . Thus , this function could cause data 
to be lost if it is issued before a CLOSE during READ/WRITE processing 

J.l.2.2 WRITE END-OF-FILE - function Code 2 

This request writes an end-of-file (EOF) record on magtape. It 
may cause data to be lost as described under OFFLINE. 

J.l.2.3 REWIND - function Code 3 

The REWIND request performs the same function as OFFLINE except 
that the SELECT REMOTE status does not go off. 

J.l.2.4 SKIP RECORD (S) - function Code 4 


Skips forward over the requested number of records (SFBLK+4) 
until either the SKIP count is exhausted or until an EOF record is 
encountered, in which case the EOF is spaced over and counted, but 
the operation terminates and a residue count (SFBLK+6) is returned 
(if any) . 


J.l.2.5 BACKSPACE RECORD (S) - function Code 5 


This request skips backwards over the requested number of rec- 
ords until either the SKIP count is exhausted or an EOF or the BOT 
marker is encountered. If an EOF is encountered it is spaced over 
and counted, but the operation terminates and a residue count is 
returned (if any) . If the BOT marker is encountered, it is not 
skipped or counted. Instead, the operation is terminated and a 
residue count is returned. 

J. 1.2.6 SET DENSITY AND PARITY - function Code 6 


This request is ignored for 9-track tapes; it sets density and 
parity as follows for 7-track tapes: 
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DENSITY (SFBLK+5) 


PARITY (SFBLK+4) 


0 = 200 BPI 0 = ODD 

1 = 556 BPI 1 = EVEN 

2 = 800 BPI 

3 = 800 BPI Dump Mode 


The default density and parity are 800 BPI Dump Mode, ODD. ±n 
this mode, one byte from core is represented as two bytes on 7-track 
magtape. Changing from this default causes one byte from core to 
be represented by one byte on tape with a loss of the two high order 
bits (6-7) of the byte. 


J. 1 . 2 . 7 TAPE UNIT STATUS - function Code 7 

This request returns the current status of the tape unit in 
SFBLK+2 in the following form: 


Bits 

0 ~ 2 


3-6 

7 

8 
9 

10 

11 


12 

13 - 14 


15 


Content 

Last command was : 

0 = OFFLINE 

1 = READ 

2 = WRITE 

3 = WRITE EOF 

4 = REWIND 

5 = SKIP RECORD 

6 = BACKSPACE RECORD 

Unused. 

1 = TAPE AFTER EOF (BEFORE EOF IF LAST 
COMMAND WAS BACKSPACE) 

1 = TAPE AT BOT MARKER 

1 = TAPE AFTER EOT MARKER 

1 = WRITE LOCK ON 

PARITY: 

0 = ODD 

1 = EVEN (DEFAULT = ODD) 

0=9 TRACK 
1=7 TRACK 

DENSITY: 

0 = 200 BPI 

1 = 556 BPI 

2 = 800 BPI 

3 = 800 BPI DUMP MODE 

1 = LAST COMMAND CAUSED ERROR 


Tape unit status is returned in SFBLK+2 for all special functions . 
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APPENDIX K 
PROGRAMS 


K.l The two following example program listings illustrate 

methods for utilizing DOS monitor services. Note tha t the 
assembly language expansions of the programmed requests 
are used. Users with less than 12K of core should code 
their programs as illustrated and assemble the resultant 
code with the 8K assembler. Users with 12K of core or more 
may replace the assembly language expansion code with ap- 
propriate programmed requests and assemble with MACRO-11. 
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001 * 01*0 
00000 1 
000002 
000003 
000004 
000005 
00000 6 
00000? 
000015 
000012 
00001 1 
000107 


000000 012746 * BF&X N I 
000312 
000004 104006 
000006 012?46» 

000324 
000012 104006 
000014 012746’ 

000340 

000020 0 1 2 ? 46 ’ 

000312 
000024 104016 

000026 012746’ 

000356 
000032 012746’ 

000324 
000036 104016 
000040 012746’ 

000370 

000044 01?746* 

000312 
000050 104002 
000052 0lg700t 
00 M 170 

030056 035023 LOOP 1 J 
000060 020027' 

300302 
000064 103774 
000066 312746’ 

000312 
330072 104001 
3340/4 712746' 

000162 

000100 0127461 
000324 
033134 104004 
330106 012746* 

0003?4 


fPRQGRAM *1 h I C H TORIES a MESSAGE ON The TELETPP wHXlfc 

j accepting a message from the keyboard, program repeats 


R 0 »J £0 
R l 8 % 1 
R 2 »X 2 
R3«X3 

R 4 S 5 J 4 

R 5 8 3J 5 
SPaxe 
PC 8 *7 
CP* 1 5 
UF 8 1 2 
H T 8 i 1 
ERQR«107 


MOV «UNK1 # -C5P5 UNIT INK! 

EmT 5 

MOV *LNK2»»(SP) ; I =M I T lMK2 

E mT 6 

MOV <*F I u 1 » • ($P) .’OPEN Fnw OUTPUT 
MOV **L.MK1 ,«(SP) 

EMT 16 

mov *fil 2»- (Sp) i o p e n for input 

MOV *»L.MK2 » • (SP) 

EmT 16 

MOV #M5G1»-(SP) ?wRXTf; THF message 
MOV *INK1 ,*C5P) 

EMT 2 

MOV ttUlBl + 6,Rp ISET TME BUFFER POINTER 

CLP (R03+ »CLFA« THE ADDRESS AND INCREMENT 

Cmp R0, #ui9l*60. ; enq of Buffer? 

BUG LOOPi ? NO » GO BACK A CONTINUE CLEARING 

MOV #LNKl,-fSp) I YESfCONTTNUE 

EMT 1 

MQV **tl»l f *(5P) I N 0 . P E A 0 LNK2,UBt 
MQV **LNK2,-fSP) 

EMT 4 

MOV **LN<2 » - (Sp) I w A I T 
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000112 

000114 


000122 

000124 

000130 

|3 fjL IA 4 3'g 

000136 

000140 

000144 
000 146 

000152 

000154 


000160 


000162 

000164 

000165 

000166 


000310 

000312 

000314 

000316 

000317 

000320 


000322 

000324 

000326 

000330 

000331 

000332 

000334 
000336 
000337 
000340 
000342 
00034 4 


104001 

EMT 

1 


132767 

BITS 

I #ER0R,LlBl+3 ;any errors? 

000107 




000043 




001016 

BNE 

ERR3 

JYES.GO TO THE ERRORS 

012^46 » 

MQV 

*LNK 1 , • £5P) 

inoi .close lnki 

000312 




l 040 | 7 

EmT 

17 


<* 1 p 7 4 fi ! 

M ft l/ 

Ml juMp sa fS^l 

I .Cl D SE L N K 2 

000324 




104017 

EMT 

17 


012^46 » 

MOV 

**I*NK 1 , » C5P) 

1 , R I. S E LNkI 

000312 




104007 

EMT 

7 


01 2? 46 * 

MQV 

4LNK2,-CSp) 

1 ,RLS6 LN<2 

0 0 P 3 ? 4 




104007 

EMT 

7 


000167 

JMP 

BEGIN 


177620 





ERR 1 3 
ErR 2 i 
€R« 3 * 


104060 


EMT 60 


I EXIT 0 ^ ANY ERROR 


000l?0 LIB1I 
000 
00 0 

000000 

000310 


,*URD 60, 
.BYTE 0,0 


;max byte count 
* F 0 k M a T T F. 0 ASCII 


.WORD 0 JACTUAL BYTE COUNT 

,*,* 80 , IHESERYF. THE buffer space 


000160 ' .WORD ERR 1 I ERROR RETURN ADDRESS 

000000 LNKH ,wQRD 0 JPQINTER 


016027 

.RAO 50 

/PS 1 / 

001 

00 0 

•BYTE 1 

• 0 

04 g 420 

• R A 0 5 3 

/KB/ 


000160 ' 

1 

• v 0 R 0 ERR2 

000000 

LnK2 J 

.word p 

016030 


.RA053 / 0 $ 2 / 

001 


.BYTE 1,0 

000 



04?420 


.RAQ50 /KB/ 

000000 


.WORD 0 ;go 

002 


.BYTE 2 , 0 

00 0 



000000 

000000 

000000 

RIM* 

.WORD 0,0,0, 


I LOGIC*!, NAME 
; LI N I T 0 

f KEYBOARD 

•ERROR RETURN ADDRESS 

t KEYBOARD 

fatal error message 

I OPE N FOR OUTPUT 

•NO NAME, EXT, UlC • OR PROTECT 



00*5346 

000000 


000350 

000003 


300352 

000300 

.WORD 0 » GO To FATAL ERROR 

000354 

30 4 

,Bvrg 4,0 ?opfn for input 

000353 

000 


030356 

000000 FTL? : 

,*0RD 0,0, 3, 3,0 t NO NAME, EXT, Ulc, OR PROTECT 

000360 

000300 


000362 

000003 


000364 

300.003 


000366 

303300 


0003*0 

000210 *sGl ! 

.WORD 213 IMA* BYTE COUNT? 

3003*2 

000 

■ BYTE 3,0 •FORMATTED ASCII 

0303*3 

030 


0003*4 

003205 

, Kt'RQ MSGEN 0 -»MSGl -6 r ACTUAL BVTF COUNT 

000376 

015 

•BYTE CR,LF,Ht 

0003*7 

012 


300400 

011 


000401 

043 

• ASCII / SPEAK ROUGHLY to your l I t T 1. E Boy / 

000402 

123 


000403 

1?3 


000404 

1 0 5 


000405 

1 3 1 


030406 

113 


030407 

0 4 3 


000410 

122 


000411 

11* 


300412 

125 


000413 

107 


300414 

113 


330415 

114 


300416 

131 


030417 

343 


033423 

124 


330421 

117 


300422 

340 


330423 

1 3 1 


000424 

1 1 7 


00042b 

125 


030426 

122 


330427 

040 


030430 

114 


000431 

ill 


330432 

i£4 


300433 

124 


300434 

114 


033435 

105 


000436 

043 


030437 

1 32 


030440 

117 


030441 

131 


030442 

040 


330443 

31b 

•BYTE CR,LF,ht, 

000444 

3 1 2 
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0130445 

411 

0(3044$ 

004 

000447 

044 

000400 

101 

000451 

116 

000452 

1 (3 4 

000453 


000454 

142 

030455 

105 

000456 

101 

000457 

124 

000460 

040 

000461 

110 

000462 

11.1 

000463 

115 

000464 

044 

40*465 

127 

000466 

1 1 4 

0M0467 

105 

000470 

1 16 

000471 

0 4 4 

00047? 

1 10 

000473 

105 

000474 

044 

000475 

123 

00047 6 

116 

000477 

105 

000500 

1?5 

000501 

132 

040502 

1 05 

000603 

123 

000504 

04 4 

000505 

015 

040506 

012 

0*11647 

011 

000510 

04 3 

0405 H 

H0 

0(34512 

1 05 

440513 

04 0 

000514 

117 

044515 

116 

040516 

114 

0405 1 7 

131 

rJ» F 1 * lA fc. O 'll 

WQWJftW 

l3 i <1 

<u 4 w 

040521 

1 0 4 

000522 

1 1 7 

000523 

1«5 

000524 

123 

000525 

040 

040526 

Hi 

004527 

124 

040560 

04 0 

040531 

124 

440532 

117 

000533 

040 

040534 

101 


•ASCII / AND BEAT HIM when HE SNEEZES 


•BYTE CR,LE»HT 

•ASCII / HE Only does It TO annoy / 



000535 116 

000536 116 

000537 117 

0005*0 131 

000541 040 

0005*2 0J5 .BYTE CR,LF,Ht 

0005*3 012 

0005*0 011 

0005*5 040 .ASCII / BECAUSE we KnG*S I 

000546 1F2 

0005*7 1 05 

000550 103 

000551 101 

300552 1?5 

000553 123 

030554 103 

000555 040 

030556 110 

000557 105 

030560 340 

030561 113 

000562 116 

000563 1 1 7 

300564 127 

030565 123 

000566 040 

000567 HI 

000570 124 

000571 040 

030572 124 

030573 105 

003574 lFl 

000575 123 

000576 105 

000 577 123 


000630 

040 




300601 

315 

.byte 

CR,UF 


003632 

012 





003603 msGEND*. 




000604 

.EVEN 




000301 

.END 



BEGIN 

000303R 

CR 

a 303315 

F R n R 

ERR 1 

303 1 60R 

ERR? 

033160R 

ERR3 

Fill 

003340R 

FIL2 

3333S6R 

HT 

If 

* 030012 

LlBl 

033162R 

unki 

LNK2 

000324R 

L00P1 

0 3 3 0 5 6 R 

H5GEN0 

MSGl 

000373R 

PC 

8*003037 

i?0 

Rl 

■*003031 

R2 

8*030002 

R3 

R4 

**000034 

R5 

**030005 

SR 

• 

a 003604R 





TEASFS / 


s 003107 
0 '10 1 60 R 
s 030 011 
003312R 
« 000603 B 
a * 3 0 3 F 0 0 
8*000003 
**000006 
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Example Program #2 


I PROGRAM TO DUPLICATE A PAPER TAPE 
t USING TRAn-LEVEL REQUESTS 

t 



000000 

*33*0 





$Ps*6 



004007 

r£a%7 



000015 

CR * 1 5 



000312 

LF« 1 2 



00001 i 

rt r» 1 1 



300004 

RD*04 

iTranBlock function code for , 


330002 

*R*32 

|TRA\BlOC< FUNCTION CODE FOR . 


030107 

G« 1 87 

/ASCII G 


343000 

EODa40803 

t tr an block function/5Tatu8»eoo 


000I07 

ERQRs 107 


300000 

3l274$»9EGlNi 

03341$ 

MOV #LNK1,»(SP) 

I.INIT LNK1 

000004 

13403$ 

EMt 6 


00000$ 

3127461 

033433 

MOV #LM<2>-fSP3 

I.INIT LNK2 

000012 

134006 

£MT 6 


0003 W 

012/4$ • 

03034$ 

MOV «L.N*3#-eSP) 

UNIT LNK3 

330020 

134036 

EM? $ 


000022 

3 1 ? 7 4 6 ! 

330372 

MQV #LN<4,*f$P) 

I.INIT LNK 4 

00002$ 

104336 

EmT 6 


000000 

335367 STArTI 
333213 

clr el ag t 

JZERO EsD FLAG 

000044 

312767 MQV 

#100 , ,blki+4 unitialize buffer size 


343144 

333444 



030042 

335367 

303516 

clr buf 1*6 

I INITIALIZE I m p U T BUFFER 

00404$ 

335067 

333514 

CLR BUF 1*13 

9 INITIALIZE INPUT BUFFER 

040052 

0 1 3/4$ * 

033246 

MQV #M§G1 , • (SPj 

write LNK3,MSG1 

00005$ 

31274$’ 

MOV SINKS, -CsPI 1 


33034$ 



340062 

104032 

EmT 2 


030064 

312746 f 

MQV #LNK5f-CSP) 

J," AIT LNK3 


338346 



000070 

104081 

EMT 1 


000072 

31274$ * 

383556 

MOV #BUF1,*CSP) 

I .READ LNK4 , BUF 1 

34307$ 

812746 » 

308572 

MQV *LNK4,-CSP) 


040102 

134034 

EMT 4 


0 3 0 1 £ 4 

81274$ 1 

308572 

MOV #LNK4,^CSP) 

i.nait ln<4 

030110 

13403 1 

EMT 1 



330112 132767 
803137 
033241 


SITS *ERQR,BUFt*3 
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04012 0 
00W 1 2a 

003130 

00013? 


000140 

000144 

000150 

000152 

000 135 
000150 


000166 

0001/0 


000176 


000204 


000212 

000216 

000222 

000224 

000230 

000232 

00023 $ 

000240 


000242 

000244 

000246 

0002^0 

000251 

000252 

000254 


001050 

122767 


8nE £RR6 

CMPS *G,BUFl+6 

t G? 

000107 

000234 

001037 


BNE START 

MO 

112767 

LnOpRi 

KQV9 #R0#BUKU6 

; YES, SET UP READ 

000004 
000250 
01?746 i 

i 

MQV *81<1,»(SP) 

; .Tram lnk i , blk i 

00040*? 

012746' 

i 

MQV #LNK1»*«(SP) 


000416 
104010 
012746 ' 

i 

EMT 10 

MOV *ll»NKl,-CSP) 

7 . Ms A I T UM1 

00041 6 

104001 

032767 


EmT 1 

BIT »£00 » 6U< 1 *6 

1 T F S T FUNCTION FOR EDO 

040000 

000222 

001406 

166767 

£ MOM 1 

BEQ LOOPkJ 

SUB BL* 1 ♦ 1 0 » BLK 1 ♦4 

jRfcSET wqroCqUmT To final 

00021 S 
000210 

012767 


*QV # 1 , F L A G 1 

f BUFFER'S size 

;$et eod-flag 

00000 1 
00W040 
112767 

LOOP* 1 

Move «wR,BL<W6 

1 SE T UP WRITE 

000002 
000176 
012746 « 


HQV #0LKI,*(SP) 

* .tram lmk2,blki 

0004c? 2 
012746 i 
000430 
104010 
012746 * 


MQV #LNK2i-(SP) 

EmT 10 

HQV «LNK2,-(SP) 

MWAIT Ink? 

000430 

104001 

005767 


Emt 1 

T ST FI. AG 1 

iend of pat a? 

000006 

001274 


BnE start 

|YES,START over 

000734 


BR LOOPR 

MO, GET more 

104060 

ERRi l 

e rr?i 

£R*3I 
ER*4 I 
EPR5I 
£RR6l 
EPR7 1 

EmT 60 n XlT On AMY ERROR 

000000 

FLAG 1 l 

.WORD 0 

1 1 s >£00 RECEIVED ON read 

000067 

msgi : 

,6QR0 55. 


004 

003 

300067 

0 1 S 


•BYTE 0,0 

.*DRD 55. 

•BYTE CR,LF,h T 



K-8 



0265255 

012 


000256 

011 


000257 

114 

• ASCII 

000250 

117 


000261 

101 


00026? 

104 


0M26A 

040 


030254 

i 2 4 


000265 

101 


020266 

120 


000267 

105 


000270 

040 


000271 

111 


000272 

He 


000273 

124 


000274 

117 


000275 

040 


000276 

12? 


000277 

IPS 


000300 

101 


000301 

1 O 4 


000302 

IPS 


000303 

122 


000304 

015 

.BYTE 

000305 

012 


000306 

011 


000307 

120 

.ASCII 

000310 

125 


000311 

1?3 


000312 

110 


000313 

040 


000314 

040 


000315 

040 


000316 

040 


000317 

107 


000320 

054 


000321 

040 


000322 

103 


000323 

122 


000324 

040 


000325 

0 4 0 


000326 

040 


000327 

127 


000330 

1 ! 0 


000331 

105 


000332 

ue 


000333 

040 


000334 

122 


000335 

105 


000336 

101 


000337 

104 


000340 

131 


000341 

015 

.BYTE 

000342 

012 



000344 

.EVEN 

000344 

020242 ' 

,wORO 


/load tap£ INTO reader/ 


C»,LF, Ht 

/PUSH G, CR WHEN READY/ 


CR,LF 

ERR3 
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000346 

000000 INKS! 

.WORD 0 



000350 

016027 

• R A 0 5 3 /OS 1 / 



00035 a 

00 1 

• BYTE 1,0 



000353 

000 




000354 

£42420 

.RAO50 /KB/ 



000356 

000004 9 U Fit 

.WORD 4 



000360 

000 

•BYTE 0,0 



000361 

00 0 




000362 

000004 

.WORD 4 




000370 

* * • +4 




000370 

• EVEN 



000370 

000242 » 

•*ORD ERR4 



000372 

000000 L NK 4 S 

.WORD 0 



000374 

016027 

•SAO50 /OS1/ 



000376 

001 

•BYTE 1,0 



000377 

000 




000400 

042420 

•RAO50 /K8/ 



000402 

000000 81*1 1 

• WORD 0 



000404 

000440 » 

• WORD BUF2 



000406 

000144 

• WORD 100, 



000410 

000000 

.WORD 0 



000412 

000000 

•wORD 0 



000414 

000242 * 

•WORD ERR3 



000416 

000000 LNKU 

•WORD 0 



000420 

016031 

.RAO50 /DS3/ 



000422 

001 

• 8 Y TE 1,0 



000423 

000 




000424 

063320 

•RAO50 /PR/ 



000426 

000242 1 

.WORD ER«2 



000430 

000000 LN«2* 

•WORD 0 



000432 

016032 

•RAO50 /DS4/ 



000434 

001 

•byte 1,0 



000435 

000 




000436 

063200 

•RAOS0 /PP/ 




000604 Bl)F2! 

•■•+100, 




000001 

• END 



BEGIN 

000000R 

BL«1 0 0 0 4 0 2 R 

9UF 1 

0 /i 0 3 5 6 R 

BUF2 

0 0 0 4 4 0 R 

CR > 000015 

ENDM 

0001 70R 

EDO • 

040000 

E«OR ■ 000107 

ERR 1 

000242R 

ERR2 

000242R 

ERR3 00024?r 

ERR4 

0 0 0 2 4 2 R 

ERR5 

000?42R 

ERR6 000242R 

FRR7 

000242R 

FUG1 

000244R 

G * 000107 

hT 

S 00 0011 

If « 

000012 

LNK1 0 0 0 4 1 6 R 

I.NK2 

000430R 

LNK3 

000346R 

L.NK4 000372R 

LOopr 

0 0 0 1 3 2 R 

IQOPw 

000204R 

MSG 1 000246R 

PC 

»%M0007 

RO ■ 

000004 

R 0 *%000000 

SP 

8X000006 

START 

000030R 

wR a 000002 

• 

9 000604R 
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APPENDIX M 
CHARACTER CODES 


N.l CARD CODES 


CARD CODES 
(ANSI X3.26— 1970) 


\Zone 

Digit's^ 

12 

li 

0 

i 

12 

0 

12 

11 

11 

0 


12 

9 

11 

9 

0 

9 

9 

12 

0 

9 

12 

11 

9 


& 

— 

0 

space 

{ 

1 

} 


i 

1 

a 

m 

D 

i 

B 

B 

fl 

■ 

SOH 

DC1 





2 

EH 

a 

a 

2 

D 

B 

a 


STX 

DC2 


SYN 



3 

a 

B 

Q 

3 

B 

B 

B 

■ 

ETX 

DC3 





4 

El 

QQH 

El 

4 

B 

31 


■ 







5 

a 

B 

□ 

5 

e 

B 

m 

□ 

HT 


LF 




6 

a 

El 

□ 

6 

B 

B 

m 

a 


BS 

ETB 




7 

m 

a 

m 

7 

B 

B 

a 


DEL 


ESC 

EOT 



8 

a 

B 

a 

8 

B 

B 

a 

a 


CAN 





9 

m 

a 

m 

9 

B 

B 

a 



8-1 



' 

1^23 






EM 



NUL 

DLE 

8-2 

n 

a 

D 












8-3 


a 

■ 

# 





VT 






8-4 

B 

B 

m 

mm 





FF 

FS 


DC4 



8-5 

m 



’ 





CR 

GS 

ENQ 

NAK 



8-6 

+ 

a 

> 

= 





SO 

RS 

ACK 




8 - 7 

\ 


a 

am 






SI 

US 

BEL 

SUB 




NOTES 

To determine the card punch for a particular character, locate the character 
in the table and read the corresponding zone punch and then digit punch. 
For example, the card punch for a % is 0-8-4. 

To obtain the character corresponding to a particular card punch, locate the 
junction of the zone punch and the digit punch. For example, the character 
corresponding to the card punch 12-1 1-9 is r. 

Slots that do not contain characters represent card punches for which there 
are no ASCII equivalents. 
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M. 2 ASCII CHARACTER SET 


ASCII CHARACTER SET 
ASCII-1968 (ANSI X3.4-1968) 

To obtain octal or decimal ASCII representation of a character, add the row value 
to the column value. 


\Column 

\Value 

Row\ 

Value 

000 

000 

008 

010 

016 

020 

024 

030 

032 

040 

040 

050 

048 

060 

056 

070 

064 

100 

072 

110 

080 

120 

088 

130 

096 

140 

104 

150 

112 

160 

120 

170 

0 

NUL 

BS 

DLE 

CAN 

space 

( 

0 

8 

@ 

H 

P 

X 

grave 

h 

P 

X 

1 

SOH 

HT 

DC1 

EM 

! 

) 

1 

9 

A 

I 

Q 

Y 

a 

i 

q 

y 

2 

STX 

LF 

DC2 

SUB 

99 

* 

2 


B 

J 

R 

Z 

b 

j 

r 

z 

3 

ETX 

VT 

DC3 

ESC 

# 

+ 

3 

9 

C 

K 

S 

[ 

c 

k 

s 

{ 

4 

EOT 

FF 

DC4 

FS 

$ 

9 

4 

< 

D 

L 

T 

\ 

d 

1 

t 

1 

5 

ENQ 

CR 

NAK 

GS 

% 

- 

5 

= 

E 

M 

U 

] 

e 

m 

u 

} 

6 

ACK 

SO 

SYN 

RS 

& 


6 

> 

F 

N 

V 

(?) 

f 

n 

V 

(ESC) 

7 

BEL 

SI 

ETB 

US 

9 

apos 

1 

7 

? 

G 

O 

w 


g 

o 

w 

DEL 


} 

} 


decimal ASCII 
octal ASCII 


Differences in the ASCII Standard 



Octal (ASCII 1963) 

ASCII 

1968 


136 

t 


(circumflex) 


137 

<— 


(underline) 


176 

ESC 



NUL 

NULL 


DLE 

DATA LINK ESCAPE (tP) 

SOH 

START OF HEADING (tA) 


DC1 

DEVICE CONTROL 1 (tQ) 

STX 

START OF TEXT (tB) 


DC2 

DEVICE CONTROL 2 (tR) 

ETX 

END OF TEXT (tC) 


DC3 

DEVICE CONTROL 3 (tS) 

EOT 

END OF TRANSMISSION (ID) 


DC4 

DEVICE CONTROL 4 (STOP) (tT) 

ENQ 

ENQUIRY (tE) 


NAK 

NEGATIVE ACKNOWLEDGE (tU) 

ACK 

ACKNOWLEDGE (tF) 


SYN 

SYNCHRONOUS IDLE (IV) 

BEL 

BELL (tG) 


ETB 

END OF TRANSMISSION BLOCK (tW) 

BS 

BACKSPACE (tH) 


CAN 

CANCEL (tX) 

HT 

HORIZ. TABULATION (tl) 


EM 

END OF MEDIUM (tY) 

LF 

LINE FEED (t J) 


SUB 

SUBSTITUTE (tZ) 

VT 

VERT. TABULATION (tK) 


ESC 

ESCAPE (t [) 

FF 

FORM FEED (tL) 


FS 

FILE SEPARATOR (t\) 

CR 

CARRIAGE RETURN (tM) 


GS 

GROUP SEPARATOR (t ] ) 

SO 

SHIFT OUT (tN) 


RS 

RECORD SEPARATOR (tt) 

SI 

SHIFT IN (tO) 


US 

UNIT SEPARATOR (t<~) 


DEL DELETE (RUBOUT) 


The tx character is produced by depressing the CTRL key and at the same time depressing the x character 
key. 
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NOTES 


1 . Teleprinters manufactured by Teletype Corporation, Skokie, Illinois, have used codes 1 75 (ALT) and 
176 for ESC. Programs may forgo the use of }• (175) and ~ (176) in order to use these codes as ESC on 
older teleprinters. 

2 . ASCII is a seven bit character code with an optional odd parity bit (200) added for many devices. Pro- 
grams normally use just seven bits internally; the 200 bit is either stripped or added so the program will 
operate with either parity or non-parity generating devices. 

ISO Recommendation R646 and CCITT Recommendation V.3 (International Alphabet No. 5) is identi- 
cal to ASCII except that number sign (043) is represented as £ instead of # and certain characters are 
reserved for national use. 
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APPENDIX N 


GLOSSARY AND ABBREVIATIONS 


ABC. 

Akcnli ifa 

A/D 

Analog -to-digital 

ADC 

Add Carry 

ADRS 

Address 

ASCII 

American Standard Code for Information Interchange 

ASL 

Arithmetic Shift Left 

ASR 

Arithmetic Shift Right 

Automatic Send/Receive 

B 

Byte 

BAR 

Bus Address Register 

BBSY 

Bus Busy 

BCC 

Branch if carry dear 

BCS 

Branch if carry set 

BEQ 

Branch if equal 

BG 

Bus Grant 

BGE 

Branch if greater or equal 

BGT 

Branch if greater than 

BHI 

Branch if higher 

BHIS 

Branch if higher or same 

BIC 

Bit Clear 

BIS 

Bit Set 

BIT 

Bit Test 

Bit Map 

A table describing the availability of space. Each bit in the 
table indicates the state (occupied or free) of one segment of 
storage, for example a block on a bulk storage device. 

BLE 

Branch if less or equal 

BLOS 

Branch if lower or same 

BLT 

Branch if less than 

BMI 

Branch if minus 

BNE 

Branch if not equal 

BPL 

Branch if plus 

BR 

Branch 
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BRD 

Bus Register Data 

BRX 

Bus Request 

BSP 

Back Space 

BSR 

Bus Shift Register 

Back Space Record 

BSY 

Busy 

Buffer 

A storage area. 

Buffer Use Table 

A bit map in the permanently resident monitor, which describes 
the availability of buffers in the free core area. 

BVC 

Branch if overflow clear 

BVS 

Branch if overflow set 

CBR 

Console Bus Request 

CIL 

Core Image Library 

CILUS 

Core Image Library Update & Save Program 

CLC 

Clear Carry 

CLK 

Clock 

CLN 

Clear Negative 

CLR 

Clear 

CLV 

Clear Overflow 

CLZ 

Clear Zero 

CMP 

Compare 

CNPR 

Console Non processor Request 

CNTL 

Control 

COM 

Complement 

COND 

Condition 

CONS 

Console 

CONT 

Contents 

Continue 

Contiguous File 

A file consisting of physically contiguous blocks on a bulk 
storage device. 

Core Bit Map 

That portion of a Permanent Bit Map which happens to be in 
core. Not to be confused with the Buffer Use Table. 

Core Image 

A copy of what a program or other data would look like if 
it were in core . 

CP 

Central Processor 

CSI 

Command String Interpreter 

CSR 

Control and Status Register 
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D 

D/A 

DAR 

DAT 


Dataset 


DAT I 
DAT IP 
DATO 
DAT OB 
DBR 
DC DR 
DDB 


DE 

DEC 


Default Device 


DEL 

DEP 

DEPF 

Device Driver 


DIV 

DMA 

DSEL 

DST 

DSX 


Data 

Digita!-to-analog 
Device Address Register 

Device Assignment Table. Contains the specifications from 
ASSIGN commands. 

A logical collection of data which Is treated as an entity by 
a program. For a more detailed description see Section 1 .6.1 . 

Data In 

Data In, Pause 
Data Out 
Data Out, Byte 
Data Buffer Register 
Decoder 

Dataset Data Block. Contains Monitor control information 
for a dataset . 

Destination effective address 
Decrement 

Digital Equipment Corporation 

The device specified in the Link Block of a dataset, and which 
is used for I/O operations on that dataset if there is no other 
device assigned in a DAT entry for the dataset. 

Delay 

Deposit 

Deposit Flag 

The minimal routine which controls physical hardware 
activities on a peripheral device. The device driver is the 
interface between a device and the common, device- 
independent I/O code in the monitor. 

Divide 

Direct Memory Access 
Device Select 
Destination 

Display, X-deflection Register 


EMT 

ENB 

EOD 

EOF 

EOM 

ERR 


Emulator Trap 

Enable 

End-of-data 

End-of-file 

End-of-medium 

Error 
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EX 

EXAM 

EXAMF 

EXEC 

EXR 


External 
Examine 
Examine Flag 
Execute 
External Reset 


F 

Fatal Error 
FBM 

FCTN 

FIB 


File 

FILO 

FLG 


Flag (part of signal name) 

An error from which a user's program cannot recover. 

File Bit Map - A device-resident bit map with bits flagged for 
the blocks used for a single file. Used on DECtape to aid in 
the deletion process. 

Function 

File Information Block. Contains (in core) information from 
the UFD and other sources when a file is open. 

A physical collection of data which resides on a directory- 
structured device and is referenced through its name. 

First in, last out 

Flag 


GEN 


Generator 


INC 

INCF 

IND 

INDIVR 

INH 

INIT 

INST 

Interleave Factor 


INTR 

INTRF 

I/O 

IOT 


Increment 

Increase 

Increment Flag 

Indicator 

Integer Divide Routine 

Inhibit 

Initialize 

Instruction 

The optimal minimum distance, measured in number of 
physical device blocks, between logically adjacent blocks 
of a linked file. Presently it is four on all PDP-11 bulk 
storage devices. For example, if physical block N is 
assigned to block 1 of a linked file, then physical block 
N+4 would be the closest device block that could be 
assigned to block 2 of that file. 

Interrupt 

Interrupt Flag 

Input/Output 

Input/Output Trap 
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IOX 

IR 

IRD 

ISR 


input/Output Executive Routine 
Instruction Register 
Instruction Register Decoder 
Instruction Shift Register 


JMP 

JSR 

Julian Date 


KSB 


LIFO 

Linked File 


Linker 


LKS 

Load Module 

LOC 

LP 

LSB 

LSBY 


Jump 

Jump to subroutine 

A 5-digit (decimal) numerical representation of the date, in 
which the two high-order digits give the year (1900=00, 
1999=99) and the three low-order digits give the day 
within the year (January 1 = 001 , December 31 = 365 
(366 for leap year)). For example, January 28, 1971 
is represented as 71028. 


Keyboard Swap Buffer. The non-resident routines which 
process keyboard commands are brought into the keyboard 
swap buffer. 


Last In, First Out 

A file consisting of a set of blocks within which an ordering 
is specified through the use of a link word imbedded within 
each block. 

A systems program which creates a load module to be loaded 
into core memory. The linker relocates and links internal and 
external symbols to provide communication between independ- 
ently assembled programs. 

Line time clock status register 

The output of the linker. A program in absolute binary 
form ready for loading and executing on a PDP-1 1 . 

Location 
Line Printer 
Least Significant Bit 
Least Significant Byte 

i «. c? ? j. 

LCUSI Ji^lllll^UIII L/iyil 


MA 

MAR 

MBR 

MEM 

MFD 

ML 

MOV 


Memory Address 
Memory Address Register 
Memory Buffer Register 
Memory 

Master File Directory. Contains the names and locations of 
all UFDs on a file-structured device. 

Memory Location 

Move 
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MRT 

MSB 

MSB 

MSBY 

MSD 

MSEL 

MSYN 


Monitor Residency Table. Contains the address (on disk 
or in core) of all non-resident Monitor modules. 

Most Significant Bit 

Monitor Swap Buffer. The non-resident routines which process 
requests to the Monitor are brought into the main swap buffer. 

Most Significant Byte 

Most Significant Digit 

Memory Select 

Master Sync 


ND 

NEG 

NOR 

NPG 

NPR 

NPRF 

NS 


Negative Driver 
Negate 
Normalize 
Nonprocessor Grant 
Nonprocessor Request 
Nonprocessor Request Flag 
Negative Switch 


Object Module 

ODT 

OP 

Operator 

OPR 

&TS 


The relocatable binary output of an assembler or compiler. 

Octal Debugging Technique 

Operate 

Operation 

A user communicating directly with the Monitor through the 
keyboard . 

Operator 

Operand 

0/$J£rc r e»+t 


PA 

PAL 

Parity Bit 

PB 

PBM 


PC 

PD 

PDP 

PERIF 


Parity Available 
Program Assembly Language 

A binary digit appended to an array of bits to make the 
sum of all the bit values always odd or always even. 

Parity Bit 

Permanent Bit Map - A bit map which describes the avail- 
ability of space on a DECtape or disk. It resides on the 
device it describes, and can be read into core in segments, 
called Core Bit Maps, for reference or updating. 

Program Counter 

Positive Driver 

Programmed Data Processor 

Peripheral 
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PGM 

PP 

PPB 

PPS 

PR 

PRB 

PROC 

PRS 

PS 

PTR 

PTS 

PUN 


Program 

Paper Tape Punch 

Paper Tape Punch Buffer Register 

Paper Tape Punch Status Register 

Paper Tape Reader 

Paper Tape Reader Buffer Reaister 

Processor 

Paper Tape Reader Status Register 

Processor Status 
Positive Switch 

Priority Transfer 

Paper Tape Software System 

Punch 


Radix-50 packed ASCII 

RD 

RDR 

REG 

REL 

RES 

ROL 

ROM 

ROR 

R/S 

RTI 

RTS 

R/W 

R/V/SR 

S 

SACK 

SAL 

SAM 

SBC 

SC 

SE 


A format in which 3 ASCII characters (from a subset of all 
ASCII characters) are packed into a single 16-bit word. 

Read 

Reader 

Register 

Release 

Reset 

Rotate Left 

Read-only Memory 

Rotate Right 

Rotate/Shift 

Return from Interrupt 

Return from Subroutine 

Read/Write 

Read/Write Shift Register 
Single 

Selection Acknowledge 
A friend of SAM . 

Swap Area Manager 
Subtract Carry 
Single Cycle 
Source Effective Address 
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SEC 

Set Carry 

SEL 

Select 

SEN 

Set Negative 

SEV 

Set Overflow 

SEX 

Sign Extend 

SEZ 

Set Zero 

SI 

Single Instruction 

SP 

Stack Pointer 

Spare 

SR 

Switch Register 

SRC 

Source 

SSYN 

Slave Sync 

ST 

Start 

STPM 

Set Trap Marker 

STR 

Strobe 

SUB 

Subtract 

SVC 

Service 

SVT 

System Vector Table 

SWAB 

Swap Byte 

Swapping 

The movement of programs or program sections from 
secondary storage to core. 

TA 

Trap Address 

Track Address 

Table 

A collection of data in a form suitable for ready reference. 

TEMP 

Temporary 

TK 

Teletype Keyboard 

TKB 

Teletype Keyboard Buffer Register 

TKS 

Teletype Keyboard Status Register 

TP 

Teletype Printer 

TPS 

Teletype Printer Status Register 

TRT 

Trace Trap 

TSC 

Timing State Control 

TST 

Test 

UFD 

User File Directory. Contains the names and locations of 
all files created under a UIC. (See MFD.) 

UIC 

User Identification Code. A code which associates a user 
with one of the UFDs on a device. 
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User 

User Program 
UTR 

VEC 

WC 

WCR 

XDR 

XRCG 

XWCG 

YDR 

YRCG 

YWCG 


The person who is using the Monitor. He may use the 
Monitor as an operator, or via a program. 

Any program written by a user to run under the Monitor. 

User Trap 

Vector 

Word Count 
Word Count Register 

X-line Driver 

X-line Read Control Group 

X-line Write Control Group 

Y-line Driver 

Y-line Read Control Group 
Y-line Write Control Group 
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APPENDIX O 

FILENAME EXTENSIONS 


Extension Attribute 


ALG ALOGL source file 

BAS BASIC source file 

BAK Backup file 

BLI BLISS source file 

CBL COBOL source file 

CIF Core Image File 

CIL Core Image Library 

CMD Command file 

CRF Input to cross-referencing program 

DA.T DATA file for FORTRAN job 

DDT Reserved for DDT 

DGN Diagnostic message file 

FTN FORTRAN source file 

FCL FOCAL source list 

LBO Library of object modules (other types of 

libraries may also be implemented) 

LCL Linked core image library 

LDA Load module. Absolute 

LDR Load module, Relocatable 

LOG Logging file 

LSP LISP source file 

LST Listing file 

MAC MACRO assembler source file 

MAP MAP file 

MFD Master file directory 

OBJ Object module 

OPR Program generation information 

OVR Overlay 

PAL PAL assembler source file 

PLl PL/1 source file 

RNO Reserved for RUNOFF program 

ROL Reserved for ROLLIN program 

RPG RPG source file 

SNO SNOBOL source file 

SPC SPEC format text 

STB Symbol Table (Link— 11 output ) 

SYM File of symbols 

SYS System management 

TMP Temporary scratch file 

UFD User File Directory 


0-1 




INDEX 


Abbreviations, N-l 
Access , 

direct, 3-33 
random, 3-31 
.ALLOC request, 3-39 
. APPND request, 3-43 
ASCII to binary conversion, 
3-71, 3-73 

ASCII mode transfer, 3-88 
ASR-33 Teletype, H-l 
Assembler directive, 

. GLOBL, 3-18 
. GLOBL OPN , C-l 
. MCALL , 3-1 

ASSIGN command, 2-13, 2-14 
Assignment, device, 2-13, 3-17 
Automatic deletion, 3-46 


BEGIN command, 2-15, 2-16, 2-17 
after crash, 2-16 
. BIN2D request, 3-72 
Binary to ASCII conversion, 3-72, 
3-74 

Binary mode transfer, 3-88 
. BIN20 request, 3-73 
BLKBLK (BLOCK block) , 3-94 
BLOCK level I/O, 1-2 
.BLOCK request, 3-31, 3-33 
Block, 

contiguous, 1-9 
file, 3-47, 3-101 
linked, 1-9, 3-8, 3-47, 3-101 
run, 3-47 
Buffer area, 1-4 
Buffer, 

keyboard, 2-9 
line, 3-6 

BUFHDR (Line Buffer Header) , 3-87 


Card punch character codes, M-l 
Changing protection code, 3-42 
Character codes, 

ASCII, M-2 
punch card, M-l 
Character deletion, 2-7 
Characters , 

special keyboard, 2-7, 2-8 
teleprinter input, 2-2 
CIL (Core Image Library), 3-63 
.CLOSE request, 3-26 
Command conventions, 2-12 
Commands , 

allocate system resources, 

2-11 

exchange information with sys- 
tem, 2-11 


keyboard, 1-2, 2-10, 2-11, 3-11, 
3-51 

legal, 2-3 

manipulate core images, 2-11 
miscellaneous, 2-11 
start program, 2-11 
stop program, 2-11 

summarv . n— i 

ASSIGN, 2-13, 2-14 
BEGIN, 2-14 through 2-17 
after program crash, 2-16 
CONTINUE, 2-18 
DATE, 2-19 
DUMP, 2-20 
ECHO, 2-21 
END, 2-22 
FINISH, 2-23 
GET, 2-24 
KILL, 2-25 
LOGIN, 2-10, 2-26 
MODIFY, 2-27 
ODT , 2-29 
PRINT, 2-30 
RESTART, 2-31, 3-51 
RUN, 2-32 
SAVE, 2-34 
STOP, 2-36 
TIME, 2-37 
WAIT, 2-38 

Commands listed by functions, 2-2 
Command String Interpreter (CSI) , 

2- 1, 2-5, 3-75 through 3-79, 1-1 
interfacing with, 3-75 

Comments, 2-8 

Completion of processing, 3-36 
Contiguous file, 1-9, 3-23, 3-30, 
creation, 3-39 
Contiguous block, 1-9 
CONTINUE command, 2-18 
Controller, device, 1-8 
Conventions, command format, 2-12 
Conversion, 

ASCII to binary, 3-71, 3-73 
binary to ASCII, 3-72, 3-74 

date/time from binary to ASCII, 

3- 57 

Radix-50, 3-67 
Conversion table, 
mathematical, L-12 
octal-decimal, L-l 
.CORE request, 3-42 
Core Image Library (CIL) , 3-63 
Core map, 1-5 
Core organization, 1-4 
Crash, program/system, 2-16 
CSI (see Command String Interpreter) 
.CSI1 request, 3-76 
.CSI2 request, 3-77 
CTRL/C keys, 2-7 


X-l 



Current user's UIC request, 3-59 
. CVTDT request, 3-57 


Data mode, 2-4 
Dataset, 1-8 

specifier, 2-12 
DATE command, 2-19 
Date conversion binary to ASCII, 
3-57 

.DATE request, 3-55 
Debugging, 2-29 
DECtape Drive TC11, H-14 
.DELET request, 3-41 
Deletion, 

automatic, 3-46 
of characters, 2-7 
of file, 3-41 
of line, 2-8 
Device, 

assignment, 2-13, 3-17 
controller, 1-8 
directory, 1-9 
driver level, 1-2 
independence, 1-1, 3-8, 3-16 
mnemonics, 2-12, 3-68, A-l 
name request, 3-60 
Devices, 

file-structured, 1-9, 3-30 
non-file structured, 1-9 
peripheral, H-l 
Direct access, 3-33 
Directory, device, 1-9 
. D2BIN request, 3-71 
$ symbol, 2-10 
DUMP command, 2-20 


File , 

deletion, 3-41 
directories, 1-3 
protection, 3-42 
protection codes, 3-86 
structure, 1-9 
Filename Block, 3-82 
Filenames, 2-6, 3-42 
extension, 2-6 
reserved extension, 0-1 
search for specified, 3-44 
File-structured device, 1-9 
FINISH command, 2-23 
Floating-point exception vector, 

3-66 

Format conventions for commands, 2-12 
Formatted level I/O, 1-2 
Free core, 1-4 
Functions, 2-2, 2-3 
special I/O, J-l 
Function Word, 3-99 


GET command, 2-24 
Getting on the system, 2-10 


Global 

name 

restriction, 3-19 

Global 

names 


ALO, 

3-39 


APP, 

3-43 


BLO, 

3-31 


CDT , 

3-57 


CLS , 

3-26 


CSM, 

3-77 


CSX, 

3-76 


CVT , 

3-67, 

3-70 through 3-74 

DEL, 

3-41 


DIR, 

3-44 


GUT, 

3-50 

through 3-56, 3-59 


ECHO command, 2-21 
Echo, keyboard, 2-21 
EMT instructions, 3-18 
EMT codes, summary, B-l 
END command, 2-22 
Equivalence, Radix-50, A-l 
Error conditions, file name block, 
3-83 through 3-86 
Error messages, 1-6 
summary, F-l 
Example programs, K-l 
Exception interrupt vector, 3-66 
Execution start, 2-15 
.EXIT request, 3-49 


through 3-66 
INR, 3-20 
OPN , 3-22 
PRO, 3-46 
REC, 3-30 
REN, 3-42 
RLS , 3-21 
RUN, 3-47 
RWN, 3-28, 3-29 
SPC, 3-37 
STT, 3-38 
TRA, 3-33 
XIT , 3-49 
.GLOBL assembler directive, 3-18 
.GLOBE OPN assembler directive, C-l 


FILBLK (File Block) , 3-82 
File (definition) , 1-8 

contiguous, 1-9, 3-23, 3-30 
linked, 1-9, 3-23, 3-43 
File block, 3-47, 3-101 
parameter, 3-75 


Glossary, N-l 
. GTCIL request, 3-63 
.GTPLA request, 3-61 
. GTSTK request, 3-64 
. GTUIC request, 3-59 
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Hardware configurations, 1-6 
Header, Line Buffer, 3-9, 3-87 


. INXT request, 3-20 

Interrupt priority level, 3-18 

Interrupt vectors, 1-4 

I/O functions, special, J-l 

I/O levels, formatted, 1-2 

I/O services, 3-1 

IOT instructions, 3-18 


.KEEP request, 3-46 
Keyboard , 
buffer, 2-9 

character processing, 2-9 
commands, 1-2, 2-11 
echo, 2-21 
KILL command, 2-25 


Legal commands. Monitor, 2-3 
Level of transfer, 3-6 
Levels of I/O, 1-2 
Line, (definition of) , 1-9 
Line Buffer Header, 3-6, 3-9, 3-87 
Line deletion, 2-8 
Link Block, 1-9, 3-8, 3-47, 3-80, 
3-101 

parameters, 3-75 
Link pointer, 3-19 
Linked file, 1-9, 3-23, 3-43 
Listing of SYSMAC.SML (system 
macro file) , G-l 
LNKBLK (Link Block) , 3-80 
Load address, 3-100 
Load module/core image, 3-100 
Logical names, 1-1, 2-12 
LOGIN command, 2-10, 2-26 
.LOOK request, 3-44 
LP11 Line Printer, H-5 


Magtape Drive, TU10, H-9 
Master File Directory (MFD) , 1-9 
. MCALL assembler directive, 3-1 
Messages, error, 1-6 
summary, F-l 

MFD (Master File Directory) , 1-9 
Mnemonics, device, 3-68 
summary, A-l 
Mode Byte, 3-88 
Modes of operation, 2-4 
Mode of transfer, 3-8, 3-28 
MODIFY command, 2-27 
. MONF request, 3-54 
. MONR request, 3-53 


Monitor, 1-1 

command conventions, 2-12 
commands by function, 2-2 
core organization, 1-4 
messages, 1-6 
mode , 2-4 

parameters, 3-50, 3-52 
requests, summary of, 3-4, 3-5, 
E-l 

restrictions, 3-18 


Names , 

logical, 1-1 
physical device, A-l 
Non-file structured device, 1-9 


. 02BIN request, 3-73 
ODT command, 2-29 
.OPN request, 3-22 
. OPENx request, 3-22 through 3-26 
Organization, core, 1-4 
Overlay/Program, 3-101 
Overlays and subsidiary routines, 
C-l 


Paper tape reader/punch, H-3 
Parameters , 

File Block, 3-75 
Link Block, 3-75 
Monitor, 3-50, 3-52 
Peripheral devices, H-l 

Radix-50 representation, 3-68 
Physical device names, A-l 
Pointer, link, 3-19 
PRINT command, 2-30 
Processing , 

completion of, 3-36 
keyboard character, 2-9 
Program crash, 2-16 
Program low address (PLA) , 3-61 
Program status, 2-4 
Program Status Word (PSW) , 3-66 
Programmed requests, 1-2, 3-1, 
3-3, 3-6 
summary, E-l 

Programmer restrictions, 3-18 
PROTECT byte, 3-46 
Protection boundary, 3-61 
Protection code change, 3-42 
PSW (program status word) , 3-66 


Radix-50 , 

conversion to packed ASCII, 3-67 
equivalence, A-l 
representation for peripheral 
devices, 3-68 
unpacked, 3-70 
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. RADPK request, 3-67 
.RADUP request, 3-70 
Random access, 

to file records, 3-10, 3-31 
to I/O level, 1-2 
.READ request, 3-28 
READ or WRITE level requests, 3-6 
RECBLK (Record Block) , 3-93 
RECORD level I/O, 1-2 
REcord level requests, 3-10 
. RECRD request, 3-30 
. RENAM request, 3-42 
Requests , 

block level, 3-12 
Monitor code for, C-l 
programmed, 1-2, 3-3, 3-6 
READ/WRITE level, 3-6 
RECORD level, 3-10 
summary of, 3-4, 3-5, E-l 
TRAN level, 3-14 
RESET instruction, 3-18 
Restart address, 3-51 
RESTART command, 2-31, 3-51 
Restrictions , 

global name, 3-19 
programmer, 3-18 
Return address, 3-100 
. RLSE request, 3-21 
. RSTRT request, 3-51 
RUBOUT, 2-9 
RUN command, 2-32 
.RUN request, 3-47 
RUNBLK (RUN Block) , 3-98 
Run block, 3-47 


SAVE command, 2-34 
Search for a specified filename, 
3-44 

Services, I/O, 3-1 
SPCBLK (Special Function Block) , 
3-97 

.SPEC request, 3-37 
Special Functions Block (SPCBLK) , 
3-97 

Special keyboard characters, 2-7 
Square bracket ([]) usage 
commands, 2-12 
Stack, 1-4 

base, 3-64, 3-65 
movement, 3-100 
storage areas, 3-18 
Start execution, 2-15 
Starting Monitor, 1-7 
.STAT request, 3-38 
Status Byte, 3-91 
.STFPU request, 3-66 
STOP command, 2-8, 2-36 
Storage areas on the stack, 3-18 
. STPLA request, 3-62 
. STSTK request, 3-65 
Subsidiary routines and overlays, 
C-l 


Summary, 

of EMT codes, B-l 
Monitor commands, D-l 
Monitor requests, 3-4 
Swapping routines into core, 3-17 
. SYSDV request, 3-60 
System, see specific subject 
SYSMAC.SML (system macro file), 
3-1 


Table standards, 1-9 
TC11 DECtape Drive, H-14 
Teleprinter input characters, 2-2 
Teletype, ASR-33, H-l 
Terminology, 1-8 
.TIME request, 3-56 
TIME command, 2-37 
Time conversion, binary to ASCII, 
3-57 

.TRAN request, 3-33 
TRAN Block (TRNBLK) , 3-95 
TRAN level requests, 3-14 
Transfer Address offset, 3-100 
Transfer levels, 1-2, 3-6 
Transfer modes, 3-28, 3-88 
ASCII/binary , 3-8 
.TRAP request, 3-50 
TRNBLK (TRAN Block) , 3-95 
TU10 Magtape Drive, H-9 


User area, 1-4 

User File Directory (UFD) , 1-9 
User Identification Code (UIC) , 2-5 
current user UIC request, 3-59 
User Mode, 2-4 

Vector, floating-point exception, 
3-66 


WAIT command, 2-38 
.WAIT request, 3-35 
. WAITR request, 3-36 
.WRITE request, 3-29 
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HOW TO OBTAiN SOFTWARE iNFORMATiON 


Announcements for new and revised software, as well as programming notes, 
software problems, and documentation corrections are published by Software 
Information Service in the following newsletters. 

Digital Software News for the PDP-8 & PDP-12 
Digital Software News for the PDP-11 
Digital Software News for the PDP-9/i5 Family 

These newsletters contain information applicable to software available from 
Digital's Program Library, Articles in Digital Software News update the 
cumulative Software Performance Summary which is contained in each basic 
kit of system software for new computers. To assure that the monthly Digital 
Software News is sent to the appropriate software contact at your installation, 
please check with the Software Specialist or Sales Engineer at your nearest 
Digital office. 

Questions or problems concerning Digital's Software should be reported to 
the Software Specialist. In cases where no Software Specialist is available, 
please send a Software Performance Report form with details of the problem to: 

Software Information Service 
Digital Equipment Corporation 
146 Main Street, Bldg. 3-5 
Maynard, Massachusetts 01754 

These forms which are provided in the software kit should be fully filled out 
and accompanied by teletype output as well as listings or tapes of the user 
program to facilitate a complete investigation. An answer will be sent to the 
individual and appropriate topics of general interest will be printed in the 
newsletter. 

Orders for new and revised software and manuals, additional Software Per- 
formance Report forms, and software price lists should be directed to the 
nearest Digital Field office or representative. U.S.A. customers may order 
directly from the Program Library in Maynard. When ordering, include the 
code number and a brief description of the software requested. 

Digital Equipment Computer Users Society (DECUS) maintains a user library 
and publishes a catalog of programs as well as the DECUSCOPE magazine 
for its members and non-members who request it. For further information 
please write to: 


DECUS 

Digital Equipment Corporation 
146 Main Street, Bldg. 3-4 
Maynard, Massachusetts 01754 
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READER'S COMMENTS 


Digital Equipment Corporation maintains a continuous effort to improve the quality and usefulness 
of its publications. To do this effectively we need user feedback — your critical evaluation of 
this manual . 

Please comment on this manual's completeness, accuracy, organization, usability and read- 
ability. 


Did you find errors in this manual? 


If so, specify by page. 


How can this manual be improved? 


Other comments? 


Please state your position. 



Date: 

Name: 


Organization: 


Street: 


Department: 


City: 

State: 


Zip or Country 
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